IKeyEnumerator::GetNext-Methode (dbgmodel.h)
Verschiebt den Iterator vorwärts und ruft den Namen des nächsten Schlüssels ab und ruft optional seinen Wert (oder einen Verweis darauf) und zugeordnete Metadaten ab.
Beachten Sie, dass je nachdem, wie dieser Enumerationerator abgerufen wurde, das im Wertfeld zurückgegebene Objekt möglicherweise der Dem Schlüssel zugeordnete Wert (EnumerateKeys), der aufgelöste Wert jeder Eigenschaft, auf die sich der Schlüssel bezieht (EnumerateKeyValues), oder ein Verweis auf den Schlüssel (EnumerateKeyReferences).
Wenn beim Auflösen des Werts des Schlüssels (z. B. für EnumerateKeyValues) ein Fehler aufgetreten ist, gibt die Methode möglicherweise einen Fehler AND 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 aufgezählten Schlüssels wird hier zurückgegeben. Der Aufrufer ist für das Freigeben dieser Zeichenfolge mit der SysFreeString-Methode verantwortlich.
value
Der Wert des aufgezählten Schlüssels wird hier zurückgegeben. Je nachdem, wie der Enumerator abgerufen wurde, kann dieser Wert dem Schlüssel zugeordnet sein (EnumerateKeys), der aufgelöste Wert jeder Eigenschaft, 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 Erfolg oder Fehler angibt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | dbgmodel.h |