OleSetContainedObject

9/8/2008

Essa função notifica um objeto incorporado em um contêiner OLE para certificar-se referência correta.

Syntax

WINOLEAPI OleSetContainedObject( 
  LPUNKNOWN pUnk, 
  BOOL fContained
); 

Parameters

• pUnk
  [no] Ponteiro para o IUnknown interface do objeto.

• fContained
  [no] Boolean que está definido como se o objeto é um objeto incorporado, TRUE ou FALSE caso contrário.

Return Value

O seguinte valores HRESULT podem ser retornados.

Valor	Descrição
S_OK	O objeto foi notificado.
E_OUTOFMEMORY	A função tem falha.
E_INVALIDARG	A função tem falha.
E_UNEXPECTED	A função tem falha.

Remarks

Passagem inválido (e, em algumas circunstâncias NULL) ponteiros para essa função faz com que uma terminação inesperada do aplicativo.

O OleSetContainedObject função notifica um objeto que é incorporado em um contêiner OLE.

A implementação de OleSetContainedObject foi alterada no 2.01 OLE para coincidir com a publicação das IRunnableObject interface.

Você pode usar OleSetContainedObject e o IRunnableObject::SetContainedObject método de forma intercambiável.

O OleSetContainedObject função consultará o objeto para um ponteiro para o IRunnableObject interface. Se bem-sucedido, a função retorna os resultados de chamado IRunnableObject::SetContainedObject.

A implementação de OleSetContainedObject Nas versões anteriores do OLE é diferente daquele descrito aqui.

Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.

Requirements

Header	ole2.h
Library	ole32.lib
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

Automation Functions
IUnknown
IRunnableObject
IRunnableObject::SetContainedObject

Concepts

Determining Supported COM APIs