GetStringsFromBlob, fonction

La fonction GetStringsFromBlob utilise des appels séquentiels pour récupérer toutes les chaînes dans les plages spécifiées.

Syntaxe

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
);

Paramètres

hBlob [in]

Handle pour l’objet BLOB.

pRequestedOwnerName [in]

Pointeur vers la section Propriétaire à partir de laquelle obtenir la chaîne.

pRequestedCategoryName [in]

Pointeur vers la section Category à partir de laquelle obtenir la chaîne.

pRequestedTagName [in]

Pointeur vers la balise pour la chaîne demandée.

ppReturnedOwnerName [out]

Pointeur vers la variable qui pointe vers l’emplacement où le nom du propriétaire sera retourné.

ppReturnedCategoryName [out]

Pointeur vers la variable qui pointe vers l’emplacement où le nom de catégorie sera retourné.

ppReturnedTagName [out]

Pointeur vers la variable qui pointe vers l’emplacement où le nom de la balise sera retourné.

ppReturnedString [out]

Pointeur vers la variable qui pointe vers l’emplacement où le nom de chaîne sera retourné.

pRestartKey [out]

Pointeur vers la variable où la clé de redémarrage sera spécifiée et retournée.

Valeur retournée

Si la fonction réussit, la valeur de retour est NMERR_SUCCESS.

Si la fonction échoue, la valeur de retour est une valeur NMERR qui indique le problème.

Si une combinaison spécifiée d’informations propriétaire, catégorie et étiquette n’existe pas, la valeur de retour est NMERR_BLOB_ENTRY_DOES_NOT_EXIST.

Lorsque l’objet BLOB est complètement parcouru dans les limites initialement spécifiées, la fonction retourne NMERR_BLOB_ENTRY_DOES_NOT_EXIST et le paramètre pRestartKey pointe vers zéro.

Notes

Lors de l’appel initial à la fonction GetStringsFromBlob , le paramètre pRestartKey pointe vers une variable qui contient la valeur zéro. Les paramètres pRequested ne peuvent être utilisés que lorsque la clé de redémarrage est égale à zéro. Dans les appels suivants, lorsque pRestartKey a des valeurs différentes de zéro, les paramètres pRequested sont ignorés. Lors de l’appel initial, tout peut pointer vers NULL, ce qui configure la requête pour retourner chaque entrée dans l’objet BLOB, une par appel suivant.

La spécification d’un propriétaire limite les chaînes retournées uniquement à ce propriétaire. Une limitation similaire est vraie pour les catégories et les balises, avec la mise en garde supplémentaire que si une catégorie est spécifiée, un propriétaire doit également être spécifié et si une balise est spécifiée, une catégorie (et donc un propriétaire) doit être spécifiée.

Lorsque l’appel initial à GetStringsFromBlob est retourné, pRestartKey pointe vers une nouvelle valeur, qui doit être spécifiée lors de l’appel suivant à la fonction pour obtenir la valeur suivante.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Netmon.h
Bibliothèque	Npptools.lib
DLL	Npptools.dll

Voir aussi

SetStringInBlob

GetBoolFromBlob

GetClassIDFromBlob

GetDwordFromBlob

GetMacAddressFromBlob

GetNetworkInfoFromBlob

GetNPPAddressFilterFromBlob

GetNPPPatternFilterFromBlob

GetNPPTriggerFromBlob

GetStringFromBlob