Metodo IKeyEnumerator::GetNext (dbgmodel.h)

Sposta l'iteratore in avanti e recupera il nome della chiave successiva e, facoltativamente, il relativo valore (o un riferimento) e i metadati associati.

Si noti che, a seconda della modalità di acquisizione di questo enumeratore, l'oggetto restituito nel campo valore può essere il valore associato alla chiave (EnumerateKeys), il valore risolto di qualsiasi proprietà a cui fa riferimento la chiave (EnumerateKeyValues) o un riferimento alla chiave (EnumerateKeyReferences).

Se si è verificato un errore durante la risoluzione del valore della chiave (per EnumerateKeyValues, ad esempio), il metodo potrebbe restituire un errore AND valore di riempimento con un oggetto error. Quando l'enumeratore raggiunge la fine della sequenza, verrà restituito E_BOUNDS.

Sintassi

HRESULT GetNext(
  BSTR                            *key,
  _COM_Errorptr_opt_ IModelObject **value,
  IKeyStore                       **metadata
);

Parametri

key

Il nome della chiave da enumerare viene restituito qui. Il chiamante è responsabile della liberazione di questa stringa con il metodo SysFreeString.

value

Il valore della chiave da enumerare viene restituito qui. A seconda della modalità di acquisizione dell'enumeratore, questo valore può essere il valore associato alla chiave (EnumerateKeys), il valore risolto di qualsiasi proprietà a cui fa riferimento la chiave (EnumerateKeyValues) o un riferimento alla chiave (EnumerateKeyReferences).

metadata

Tutti i metadati associati alla chiave vengono facoltativamente restituiti in questo argomento.

Valore restituito

Questo metodo restituisce HRESULT che indica l'esito positivo o negativo.

Fabbisogno

Requisito	Valore
intestazione	dbgmodel.h

Vedere anche

interfaccia IKeyEnumerator