Função OleSetContainedObject (ole2.h)

Notifica um objeto de que ele está inserido em um contêiner OLE, o que garante que a contagem de referência seja feita corretamente para contêineres que dão suporte a links para objetos inseridos.

Sintaxe

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

Parâmetros

[in] pUnknown

Ponteiro para a interface IUnknown do objeto .

[in] fContained

TRUE se o objeto for um objeto inserido; FALSE caso contrário.

Retornar valor

Essa função retorna S_OK com êxito. Outros valores possíveis incluem o seguinte.

Código de retorno	Descrição
E_OUTOFMEMORY	Memória insuficiente para a operação.
E_INVALIDARG	Um ou mais parâmetros são inválidos.
E_UNEXPECTED	Erro inesperado.

Comentários

A função OleSetContainedObject notifica um objeto de que ele está inserido em um contêiner OLE. A implementação de OleSetContainedObject foi alterada no OLE 2.01 para coincidir com a publicação da interface IRunnableObject . Você pode usar OleSetContainedObject e o método IRunnableObject::SetContainedObject intercambiável. A função OleSetContainedObject consulta o objeto de um ponteiro para a interface IRunnableObject . Se tiver êxito, a função retornará os resultados da chamada de IRunnableObject::SetContainedObject.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	ole2.h
Biblioteca	Ole32.lib
DLL	Ole32.dll
Conjunto de APIs	ext-ms-win-com-ole32-l1-1-2 (introduzido no Windows 10, versão 10.0.10240)

Confira também

IRunnableObject::SetContainedObject