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 value 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, pour instance), la méthode peut retourner une valeur d’erreur ET 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 responsable de la libération de 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 retournée
Cette méthode retourne HRESULT qui indique la réussite ou l’échec.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | dbgmodel.h |