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	Netmon.h
Libreria	Npptools.lib
DLL	Npptools.dll

Vedi anche

SetStringInBlob

GetBoolFromBlob

GetClassIDFromBlob

GetDwordFromBlob

GetMacAddressFromBlob

GetNetworkInfoFromBlob

GetNPPAddressFilterFromBlob

GetNPPPatternFilterFromBlob

GetNPPTriggerFromBlob

GetStringFromBlob