IRunnableObject::SetContainedObject

9/8/2008

Este método notifica um objeto que é incorporado em um contêiner OLE, que garante que contagem de referência é feita corretamente para recipientes que suporte links para incorporado objetos.

Syntax

HRESULT SetContainedObject(
  BOOL fContained 
);

Parameters

• fContained
  [no] TRUE especifica que o objeto está contido em um contêiner OLE. FALSE indica que ele não é.

Return Value

Este método oferece suporte a padrão retornar valores E_INVALIDARG, E_OUTOFMEMORY E E_UNEXPECTED, bem como o seguinte:

• S_OK
  Objeto foi marcado como uma incorporação contida.

Remarks

O IRunnableObject::SetContainedObject método permite um contêiner para informar um manipulador objeto que é incorporado no contêiner, rather than que atua como um link. Este chamar altera referência do contêiner sobre o objeto de alta segurança, o usar como padrão para externo Conexões, para fraca.

Quando o objeto é execução visivelmente, esse método é de pouca importância porque o usuário tem um bloqueio no objeto. Durante uma atualização silenciosa de um incorporado origem link, no entanto, o contêiner deve não ser consiga mantêm um objeto na execução estado depois que o link tiver sido interrompida. Por esse motivo, a referência do contêiner para o objeto deve ser fraca.

Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.

Notas para chamadores

Um aplicativo contêiner deve chamar IRunnableObject::SetContainedObject Se ela der suporte a vinculação a incorporado objetos.

Ele geralmente faz a chamar imediatamente após chamado OleCreate e nunca chama o método novamente, mesmo antes ele fecha. Além disso, um contêiner quase sempre chama esse método com fContained Definir como TRUE. O uso desse método com fContained Definido como FALSE é raro.

Chamando IRunnableObject::SetContainedObject é opcional apenas quando você sabe que o objeto incorporado não será relacionado por qualquer cliente Other Than o contêiner.

Se seu aplicativo contêiner não suporte vinculando incorporado objetos; é preferível, mas não necessário, para chamar IRunnableObject::SetContainedObject.

OleSetContainedObject é um função de ajuda que repackages convenientemente a funcionalidade oferecida por IRunnableObject::SetContainedObject.

Com a versão de OLE 2.01, a implementação de OleSetContainedObject foi alterado para chamar Falha de QueryInterface, pedir IRunnableObjecte em seguida, chamar IRunnableObject::SetContainedObject. Em outras palavras, você pode usar a interface e a função de ajuda de forma intercambiável.

Requirements

Header	objidl.h, objidl.idl
Library	ole32.lib, uuid.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

OleSetContainedObject
CoLockObjectExternal