OleSetContainedObject-Funktion (ole2.h)

  • Artikel

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
E_OUTOFMEMORY
 Unzureichender Arbeitsspeicher für den Vorgang.
E_INVALIDARG
 Mindestens ein Parameter ist ungültig.
E_UNEXPECTED
 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)

Weitere Informationen

IRunnableObject::SetContainedObject