IMoniker::Enum-Methode (objidl.h)
Ruft einen Zeiger auf einen Enumerator für die Komponenten eines zusammengesetzten Monikers ab.
Syntax
HRESULT Enum(
[in] BOOL fForward,
[out] IEnumMoniker **ppenumMoniker
);
Parameter
[in] fForward
Wenn TRUE, listet die Moniker von links nach rechts auf. Wenn FALSE, listet von rechts nach links auf.
[out] ppenumMoniker
Ein Zeiger auf eine IEnumMoniker-Zeigervariable , die den Schnittstellenzeiger auf das Enumeratorobjekt für den Moniker empfängt. Bei erfolgreicher Ausführung muss die Implementierung AddRef für das Enumeratorobjekt aufrufen. Es liegt in der Verantwortung des Aufrufers , Release aufzurufen. Wenn ein Fehler auftritt oder der Moniker keine aufzählbaren Komponenten enthält, legt die Implementierung *ppenumMoniker auf NULL fest.
Rückgabewert
Diese Methode kann die Standardrückgabewerte E_OUTOFMEMORY, E_UNEXPECTED und S_OK zurückgeben.
Hinweise
Diese Methode muss einen IEnumMoniker-Zeiger auf einen Enumerator bereitstellen, der die Komponenten eines Monikers auflisten kann. Beispielsweise erstellt die Implementierung der IMoniker::Enum-Methode für einen generischen zusammengesetzten Moniker einen Enumerator, der die einzelnen Moniker bestimmen kann, aus denen der Zusammengesetzte besteht, während die IMoniker::Enum-Methode für einen Dateimoniker einen Enumerator erstellt, der Moniker zurückgibt, die die einzelnen Komponenten im Pfad darstellen.
Hinweise für Anrufer
Rufen Sie diese Methode auf, um die Komponenten zu untersuchen, aus denen ein zusammengesetzter Moniker besteht.Hinweise für Implementierer
Wenn die neue Monikerklasse keine erkennbare interne Struktur aufweist, kann Ihre Implementierung dieser Methode einfach S_OK zurückgeben und ppenumMoniker auf NULL festlegen.Implementierungsspezifische Hinweise
Implementierung | Hinweise |
---|---|
Anti-Moniker | Diese Methode gibt S_OK zurück und legt ppenumMoniker auf NULL fest. |
Moniker der Klasse | Diese Methode gibt S_OK zurück und legt ppenumMoniker auf NULL fest. |
Dateimoniker | Diese Methode gibt S_OK zurück und legt ppenumMoniker auf NULL fest. |
Generischer zusammengesetzter Moniker | Bei erfolgreicher Ausführung gibt die Methode S_OK zurück und übergibt einen Enumerator, der die Komponentenmoniker aufzählt, aus denen die Zusammengesetzten bestehen. Andernfalls gibt die Methode E_OUTOFMEMORY zurück. |
Elementmoniker | Diese Methode gibt S_OK zurück und legt ppenumMoniker auf NULL fest. |
OBJREF-Moniker | Diese Methode gibt S_OK zurück und legt ppenumMoniker auf NULL fest. |
Zeigermoniker | Diese Methode gibt E_NOTIMPL zurück. |
URL-Moniker | Diese Methode gibt S_OK zurück und legt ppenumMoniker auf NULL fest. |
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | objidl.h |