Funzione OleSetContainedObject (ole2.h)

Articolo
02/29/2024

Notifica a un oggetto che è incorporato in un contenitore OLE, che garantisce che il conteggio dei riferimenti venga eseguito correttamente per i contenitori che supportano collegamenti a oggetti incorporati.

Sintassi

HRESULT OleSetContainedObject(
  [in] LPUNKNOWN pUnknown,
  [in] BOOL      fContained
);

Parametri

[in] pUnknown

Puntatore all'interfaccia IUnknown dell'oggetto .

[in] fContained

TRUE se l'oggetto è un oggetto incorporato; FALSE in caso contrario.

Valore restituito

Questa funzione restituisce S_OK in caso di esito positivo. Altri valori possibili includono quanto segue.

Codice restituito	Descrizione
E_OUTOFMEMORY	Memoria insufficiente per l'operazione.
E_INVALIDARG	Uno o più parametri non sono validi.
E_UNEXPECTED	Si è verificato un errore imprevisto.

Commenti

La funzione OleSetContainedObject notifica a un oggetto che è incorporato in un contenitore OLE. L'implementazione di OleSetContainedObject è stata modificata in OLE 2.01 in modo che coincida con la pubblicazione dell'interfaccia IRunnableObject . È possibile usare OleSetContainedObject e il metodo IRunnableObject::SetContainedObject in modo intercambiabile. La funzione OleSetContainedObject esegue una query sull'oggetto per un puntatore all'interfaccia IRunnableObject . In caso di esito positivo, la funzione restituisce i risultati della chiamata a IRunnableObject::SetContainedObject.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ole2.h
Libreria	Ole32.lib
DLL	Ole32.dll
Set di API	ext-ms-win-com-ole32-l1-1-2 (introdotto in Windows 10, versione 10.0.10240)

Vedi anche

IRunnableObject::SetContainedObject

Condividi tramite