IOleContainer::EnumObjects-Methode (oleidl.h)

Artikel
08/25/2023

Listet die Objekte im aktuellen Container auf.

Syntax

HRESULT EnumObjects(
  [in]  DWORD        grfFlags,
  [out] IEnumUnknown **ppenum
);

Parameter

[in] grfFlags

Gibt an, welche Objekte in einem Container aufgelistet werden sollen, wie in der Enumeration OLECONTF definiert.

[out] ppenum

Ein Zeiger auf eine IEnumUnknown-Zeigervariable , die den Schnittstellenzeiger auf das Enumeratorobjekt empfängt. Jedes Mal, wenn ein Container einen erfolgreichen Aufruf von EnumObjects empfängt, muss er die Verweisanzahl für den ppenum-Zeiger erhöhen, den die Methode zurückgibt. Es liegt in der Verantwortung des Aufrufers , IUnknown::Release aufzurufen, wenn dies mit dem Zeiger abgeschlossen ist. Wenn ein Fehler zurückgegeben wird, muss die Implementierung ppenum auf NULL festlegen.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:

Rückgabecode	Beschreibung
E_FAIL	Fehler beim Vorgang.
E_NOTIMPL	Objektenumeration wird nicht unterstützt.

Hinweise

Ein Container sollte EnumObjects implementieren, damit programmgesteuerte Clients herausfinden können, welche Objekte darin enthalten sind. Diese Methode wird jedoch in Standardverknüpfungsszenarien nicht aufgerufen.

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	oleidl.h

Weitere Informationen