IDynamicKeyProviderConcept::EnumerateKeys-Methode (dbgmodel.h)
Die EnumerateKeys-Methode für einen dynamischen Schlüsselanbieter ist effektiv eine Außerkraftsetzung der EnumerateKeys-Methode für IModelObject. Dadurch werden alle Schlüssel im dynamischen Anbieter aufgelistet. Der zurückgegebene Enumerator hat mehrere Einschränkungen, die von der Implementierung berücksichtigt werden müssen:
- Sie muss sich als Aufruf von EnumerateKeys und nicht als EnumerateKeyValues oder EnumerateKeyReferences verhalten. Sie muss die Schlüsselwerte zurückgeben, die keine zugrunde liegenden Eigenschaftsaccessoren auflösen (sofern ein solches Konzept im Anbieter vorhanden ist).
- Aus Sicht eines einzelnen dynamischen Schlüsselanbieters ist es unzulässig, mehrere Schlüssel mit demselben Namen aufzählen zu können, die physisch voneinander getrennt sind. Dies kann bei verschiedenen Anbietern geschehen, die über die übergeordnete Modellkette angefügt sind, aber nicht aus sicht eines einzelnen Anbieters geschehen.
Syntax
HRESULT EnumerateKeys(
IModelObject *contextObject,
IKeyEnumerator **ppEnumerator
);
Parameter
contextObject
Das Instanzobjekt (dieser Zeiger), für das Schlüssel aufgezählt werden sollen.
ppEnumerator
Hier muss ein Enumerator für alle Schlüssel des dynamischen Anbieters zurückgegeben werden.
Rückgabewert
Diese Methode gibt HRESULT zurück, das Erfolg oder Fehler angibt.
Anforderungen
Anforderung | Wert |
---|---|
Header- | dbgmodel.h |