Funzione GetStringsFromBlob
La funzione GetStringsFromBlob usa chiamate sequenziali per recuperare tutte le stringhe all'interno di intervalli specificati.
Sintassi
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
);
Parametri
-
hBlob [in]
-
Handle per il BLOB.
-
pRequestedOwnerName [in]
-
Puntatore alla sezione Proprietario da cui ottenere la stringa.
-
pRequestedCategoryName [in]
-
Puntatore alla sezione Category da cui ottenere la stringa.
-
pRequestedTagName [in]
-
Puntatore al tag per la stringa richiesta.
-
ppReturnedOwnerName [out]
-
Puntatore alla variabile che punta al punto in cui verrà restituito il nome del proprietario .
-
ppReturnedCategoryName [out]
-
Puntatore alla variabile che punta alla posizione in cui verrà restituito il nome della categoria .
-
ppReturnedTagName [out]
-
Puntatore alla variabile che punta alla posizione in cui verrà restituito il nome del tag .
-
ppReturnedString [out]
-
Puntatore alla variabile che punta alla posizione in cui verrà restituito il nome della stringa.
-
pRestartKey [out]
-
Puntatore alla variabile in cui verrà specificata e restituita la chiave di riavvio.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene NMERR_SUCCESS.
Se la funzione ha esito negativo, il valore restituito è un valore NMERR che indica il problema.
Se non esiste una combinazione specificata di informazioni su Proprietario, Categoria e Tag , il valore restituito viene NMERR_BLOB_ENTRY_DOES_NOT_EXIST.
Quando il BLOB viene attraversato completamente all'interno dei limiti specificati inizialmente, la funzione restituisce NMERR_BLOB_ENTRY_DOES_NOT_EXIST e il parametro pRestartKey punta a zero.
Commenti
Nella chiamata iniziale alla funzione GetStringsFromBlob il parametro pRestartKey punta a una variabile contenente il valore zero. I parametri pRequested possono essere usati solo quando la chiave di riavvio è zero. Nelle chiamate successive, quando pRestartKey ha valori diversi da zero, i parametri pRequested vengono ignorati. Nella chiamata iniziale, tutti possono puntare a NULL, che configura la query per restituire ogni voce nel BLOB, una per ogni chiamata successiva.
Se si specifica un proprietario, le stringhe restituite vengono limitate solo a tale proprietario. Una limitazione simile è vera per categorie e tag, con l'avvertenza aggiuntiva che, se si specifica una categoria, è necessario specificare anche un proprietario e, se viene specificato un tag, è necessario specificare una categoria (e quindi un proprietario).
Quando viene restituita la chiamata iniziale a GetStringsFromBlob , pRestartKey punta a un nuovo valore, che deve essere specificato nella chiamata successiva alla funzione per ottenere il valore successivo.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| Intestazione |
|
| Libreria |
|
| DLL |
|