Método IUnsecuredApartment::CreateObjectStub (wbemcli.h)

Artigo
03/13/2024

O método CreateObjectStub cria um coletor de encaminhador de objetos para ajudar no recebimento de chamadas assíncronas do Gerenciamento do Windows. Essa função associa um coletor de objeto não seguro a um coletor de objeto local para que a segurança COM não interfira na recuperação assíncrona de objetos CIM. Como a segurança COM está sendo ignorada, o servidor remoto de Gerenciamento do Windows é considerado um componente confiável.

O paradigma geral é que a implementação original de IWbemObjectSink no processo do cliente não é usada diretamente em chamadas assíncronas para IWbemServices. Em vez disso, a implementação original e um objeto substituto são criados, unidos e, em seguida, o objeto substituto é usado nos métodos assíncronos de IWbemServices.

Sintaxe

HRESULT CreateObjectStub(
  [in]  IUnknown *pObject,
  [out] IUnknown **ppStub
);

Parâmetros

[in] pObject

Ponteiro para a implementação em processo do cliente de IWbemObjectSink.

[out] ppStub

Recebe um ponteiro para um objeto substituto a ser usado em chamadas de IWbemServices assíncronas . O usuário recebe um ponteiro IUnknown e deve chamar QueryInterface para IID_WbemObjectSink antes de usar esse objeto em chamadas assíncronas do IWbemServices .

Retornar valor

Esse método retorna códigos de erro COM padrão para QueryInterface. Ele retornará S_OK se a chamada for bem-sucedida. Se a chamada falhar porque não há suporte para a interface solicitada, o método retornará E_NOINTERFACE.

Códigos de erro específicos de COM também podem ser retornados se problemas de rede fizerem com que você perca a conexão remota com o Gerenciamento do Windows.

Comentários

Nota Como o retorno de chamada para o coletor pode não ser retornado no mesmo nível de autenticação exigido pelo cliente, é recomendável que você use a comunicação semissíncrona em vez de assíncrona. Para obter mais informações, confira Como chamar um método.

Exemplos

Para obter um exemplo completo que mostra como usar a interface IUnsecuredApartment , consulte Exemplo: Recebendo notificações de eventos por meio do WMI.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008 R2
Plataforma de Destino	Windows
Cabeçalho	wbemcli.h (inclua Wbemidl.h)
Biblioteca	Wbemuuid.lib
DLL	Unsecapp.exe