IMoniker::Enum-Methode (objidl.h)

  • Artikel

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

Weitere Informationen

IEnumMoniker

Imoniker