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 |
|
| Biblioteca |
|
| Archivo DLL |
|