IKeyEnumerator ::GetNext, méthode (dbgmodel.h)
Déplace l’itérateur vers l’avant et récupère le nom de la clé suivante et, éventuellement, sa valeur (ou une référence à celle-ci) et les métadonnées associées.
Notez que, selon la façon dont cet énumérateur a été acquis, l’objet retourné dans le champ valeur peut être la valeur associée à la clé (EnumerateKeys), la valeur résolue de toute propriété à laquelle la clé fait référence (EnumerateKeyValues) ou une référence à la clé (EnumerateKeyReferences).
En cas d’erreur lors de la résolution de la valeur de la clé (pour EnumerateKeyValues, par exemple), la méthode peut retourner une erreur AND valeur de remplissage avec un objet d’erreur. Lorsque l’énumérateur atteint la fin de la séquence, E_BOUNDS est retourné.
Syntaxe
HRESULT GetNext(
BSTR *key,
_COM_Errorptr_opt_ IModelObject **value,
IKeyStore **metadata
);
Paramètres
key
Le nom de la clé énumérée est retourné ici. L’appelant est chargé de libérer cette chaîne avec la méthode SysFreeString.
value
La valeur de la clé énumérée est retournée ici. Selon la façon dont l’énumérateur a été acquis, cette valeur peut être la valeur associée à la clé (EnumerateKeys), la valeur résolue de toute propriété à laquelle la clé fait référence (EnumerateKeyValues) ou une référence à la clé (EnumerateKeyReferences).
metadata
Toutes les métadonnées associées à la clé sont éventuellement retournées dans cet argument.
Valeur de retour
Cette méthode retourne HRESULT qui indique la réussite ou l’échec.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | dbgmodel.h |