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