Função GetStringsFromBlob

A função GetStringsFromBlob usa chamadas sequenciais para recuperar todas as cadeias de caracteres dentro dos intervalos especificados.

Sintaxe

DWORD GetStringsFromBlob(
  _In_        HBLOB hBlob,
  _In_  const char  *pRequestedOwnerName,
  _In_  const char  *pRequestedCategoryName,
  _In_  const char  *pRequestedTagName,
  _Out_ const char  **ppReturnedOwnerName,
  _Out_ const char  **ppReturnedCategoryName,
  _Out_ const char  **ppReturnedTagName,
  _Out_ const char  **ppReturnedString,
  _Out_       DWORD *pRestartKey
);

Parâmetros

hBlob [in]

Um identificador para o BLOB.

pRequestedOwnerName [in]

Um ponteiro para a seção Proprietário da qual obter a cadeia de caracteres.

pRequestedCategoryName [in]

Um ponteiro para a seção Categoria da qual obter a cadeia de caracteres.

pRequestedTagName [in]

Um ponteiro para a marca para a cadeia de caracteres solicitada.

ppReturnedOwnerName [out]

Um ponteiro para a variável que aponta para onde o nome do proprietário será retornado.

ppReturnedCategoryName [out]

Um ponteiro para a variável que aponta para onde o nome da categoria será retornado.

ppReturnedTagName [out]

Um ponteiro para a variável que aponta para onde o nome da marca será retornado.

ppReturnedString [out]

Um ponteiro para a variável que aponta para onde o nome da cadeia de caracteres será retornado.

pRestartKey [out]

Um ponteiro para a variável em que a chave de reinicialização será especificada e retornada.

Valor retornado

Se a função for bem-sucedida, o valor retornado será NMERR_SUCCESS.

Se a função não for bem-sucedida, o valor retornado será um valor NMERR que indica o problema.

Se uma combinação especificada de informações de Proprietário, Categoria e Marca não existir, o valor retornado será NMERR_BLOB_ENTRY_DOES_NOT_EXIST.

Quando o BLOB é percorrido completamente dentro dos limites especificados inicialmente, a função retorna NMERR_BLOB_ENTRY_DOES_NOT_EXIST e o parâmetro pRestartKey aponta para zero.

Comentários

Na chamada inicial para a função GetStringsFromBlob , o parâmetro pRestartKey aponta para uma variável que contém o valor zero. Os parâmetros pRequested só podem ser usados quando a chave de reinicialização é zero. Em chamadas subsequentes, quando pRestartKey tem valores não zero, os parâmetros pRequested são ignorados. Na chamada inicial, tudo pode apontar para NULL, que configura a consulta para retornar todas as entradas no BLOB, uma por chamada subsequente.

Especificar um proprietário limita as cadeias de caracteres retornadas apenas a esse proprietário. Uma limitação semelhante é verdadeira para categorias e marcas, com a ressalva adicional de que, se uma categoria for especificada, um proprietário também deverá ser especificado e, se uma marca for especificada, uma categoria (e, portanto, um proprietário) deverá ser especificada.

Quando a chamada inicial para GetStringsFromBlob retorna, pRestartKey aponta para um novo valor, que deve ser especificado na próxima chamada para a função para obter o próximo valor.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	Netmon.h
Biblioteca	Npptools.lib
DLL	Npptools.dll

Confira também

SetStringInBlob

GetBoolFromBlob

GetClassIDFromBlob

GetDwordFromBlob

GetMacAddressFromBlob

GetNetworkInfoFromBlob

GetNPPAddressFilterFromBlob

GetNPPPatternFilterFromBlob

GetNPPTriggerFromBlob

GetStringFromBlob