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 |
|
| Bibliothèque |
|
| DLL |
|