OleSetContainedObject-Funktion (ole2.h)
Benachrichtigt ein Objekt, dass es in einen OLE-Container eingebettet ist. Dadurch wird sichergestellt, dass die Verweiszählung für Container, die Links zu eingebetteten Objekten unterstützen, ordnungsgemäß durchgeführt wird.
Syntax
HRESULT OleSetContainedObject(
[in] LPUNKNOWN pUnknown,
[in] BOOL fContained
);
Parameter
[in] pUnknown
Zeiger auf die IUnknown-Schnittstelle des -Objekts.
[in] fContained
TRUE , wenn es sich bei dem Objekt um ein eingebettetes Objekt handelt; False andernfalls.
Rückgabewert
Diese Funktion gibt bei Erfolg S_OK zurück. Weitere mögliche Werte sind:
Rückgabecode | Beschreibung |
---|---|
|
Unzureichender Arbeitsspeicher für den Vorgang. |
|
Mindestens ein Parameter ist ungültig. |
|
Ein unerwarteter Fehler ist aufgetreten. |
Hinweise
Die OleSetContainedObject-Funktion benachrichtigt ein Objekt, dass es in einen OLE-Container eingebettet ist. Die Implementierung von OleSetContainedObject wurde in OLE 2.01 geändert, um mit der Veröffentlichung der IRunnableObject-Schnittstelle zusammenzufallen. Sie können OleSetContainedObject und die IRunnableObject::SetContainedObject-Methode austauschbar verwenden. Die OleSetContainedObject-Funktion fragt das Objekt nach einem Zeiger auf die IRunnableObject-Schnittstelle ab. Bei erfolgreicher Ausführung gibt die Funktion die Ergebnisse des Aufrufs von IRunnableObject::SetContainedObject zurück.
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 | ole2.h |
Bibliothek | Ole32.lib |
DLL | Ole32.dll |
APIs | ext-ms-win-com-ole32-l1-1-2 (eingeführt in Windows 10, Version 10.0.10240) |