Función GetStringsFromBlob

La función GetStringsFromBlob usa llamadas secuenciales para recuperar todas las cadenas dentro de los intervalos especificados.

Sintaxis

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]

Identificador del BLOB.

pRequestedOwnerName [in]

Puntero a la sección Propietario del que se va a obtener la cadena.

pRequestedCategoryName [in]

Puntero a la sección Categoría del que se va a obtener la cadena.

pRequestedTagName [in]

Puntero a la etiqueta de la cadena solicitada.

ppReturnedOwnerName [out]

Puntero a la variable que apunta a dónde se devolverá el nombre del propietario .

ppReturnedCategoryName [out]

Puntero a la variable que apunta a dónde se devolverá el nombre de categoría.

ppReturnedTagName [out]

Puntero a la variable que apunta a dónde se devolverá el nombre de etiqueta.

ppReturnedString [out]

Puntero a la variable que apunta a dónde se devolverá el nombre de la cadena.

pRestartKey [out]

Puntero a la variable donde se especificará y devolverá la clave de reinicio.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NMERR_SUCCESS.

Si la función no se realiza correctamente, el valor devuelto es un valor NMERR que indica el problema.

Si no existe una combinación especificada de información de propietario, categoría y etiqueta , el valor devuelto es NMERR_BLOB_ENTRY_DOES_NOT_EXIST.

Cuando el BLOB se recorre completamente dentro de los límites especificados inicialmente, la función devuelve NMERR_BLOB_ENTRY_DOES_NOT_EXIST y el parámetro pRestartKey apunta a cero.

Observaciones

En la llamada inicial a la función GetStringsFromBlob , el parámetro pRestartKey apunta a una variable que contiene el valor cero. Los parámetros pRequested solo se pueden usar cuando la clave de reinicio es cero. En las llamadas posteriores, cuando pRestartKey tiene valores distintos de cero, se omiten los parámetros pRequested . En la llamada inicial, todo puede apuntar a NULL, que configura la consulta para devolver cada entrada del BLOB, una por cada llamada posterior.

Especificar un propietario limita las cadenas devueltas solo a ese propietario. Una limitación similar es cierta para las categorías y etiquetas, con la advertencia adicional de que, si se especifica una categoría, también se debe especificar un propietario y, si se especifica una etiqueta, se debe especificar una categoría (y, por lo tanto, un propietario).

Cuando la llamada inicial a GetStringsFromBlob devuelve, pRestartKey apunta a un nuevo valor, que se debe especificar en la siguiente llamada a la función para obtener el siguiente valor.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Netmon.h
Biblioteca	Npptools.lib
Archivo DLL	Npptools.dll

Vea también

SetStringInBlob

GetBoolFromBlob

GetClassIDFromBlob

GetDwordFromBlob

GetMacAddressFromBlob

GetNetworkInfoFromBlob

GetNPPAddressFilterFromBlob

GetNPPPatternFilterFromBlob

GetNPPTriggerFromBlob

GetStringFromBlob