IKeyEnumerator::GetNext-Methode (dbgmodel.h)

Verschiebt den Iterator nach vorne und ruft den Namen des nächsten Schlüssels und optional dessen Wert (oder einen Verweis darauf) und die zugeordneten Metadaten ab.

Beachten Sie, dass das im Wertfeld zurückgegebene Objekt abhängig davon, wie dieser Enumerator abgerufen wurde, der dem Schlüssel zugeordnete Wert (EnumerateKeys), der aufgelöste Wert einer beliebigen Eigenschaft sein kann, auf die der Schlüssel verweist (EnumerateKeyValues) oder ein Verweis auf den Schlüssel (EnumerateKeyReferences).

Wenn beim Auflösen des Schlüsselwerts (für EnumerateKeyValues, für instance) ein Fehler aufgetreten ist, gibt die Methode möglicherweise einen Fehler UND Füllwert mit einem Fehlerobjekt zurück. Wenn der Enumerator das Ende der Sequenz erreicht, wird E_BOUNDS zurückgegeben.

Syntax

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

Parameter

key

Der Name des Aufzählungsschlüssels wird hier zurückgegeben. Der Aufrufer ist für das Freigeben dieser Zeichenfolge mit der SysFreeString-Methode verantwortlich.

value

Der Wert des Aufzählungsschlüssels wird hier zurückgegeben. Je nachdem, wie der Enumerator abgerufen wurde, kann dieser Wert der dem Schlüssel zugeordnete Wert (EnumerateKeys), der aufgelöste Wert einer beliebigen Eigenschaft sein, auf die der Schlüssel verweist (EnumerateKeyValues) oder ein Verweis auf den Schlüssel (EnumerateKeyReferences).

metadata

Alle Metadaten, die dem Schlüssel zugeordnet sind, werden optional in diesem Argument zurückgegeben.

Rückgabewert

Diese Methode gibt HRESULT zurück, das den Erfolg oder Fehler angibt.

Anforderungen

Anforderung	Wert
Header	dbgmodel.h

Weitere Informationen

IKeyEnumerator-Schnittstelle