IOleContainer::EnumObjects-Methode (oleidl.h)
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 |
|---|---|
|
Fehler beim Vorgang. |
|
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 |