Método IWbemUnsecuredApartment::CreateSinkStub (wbemcli.h)

Artigo
08/27/2023

O método CreateSinkStub é semelhante ao IUnsecuredApartment::CreateObjectStub e cria um coletor do encaminhador de objetos e executa verificações de acesso para receber chamadas assíncronas do Gerenciamento do Windows. CreateSinkStub difere de CreateObjectStub porque pode especificar que os retornos de chamada para o coletor devem ser autenticados.

O WMI fornece o processo de Unsecapp.exe para funcionar como o processo separado. Você pode hospedar Unsecapp.exe com uma chamada para a interface IWbemUnsecuredApartment ou IUnsecuredApartment em outras versões do Windows. IUnsecuredApartment não tem nenhum método que execute a verificação de acesso.

Uma marcar de acesso significa que Unsecapp.exe só permite que a conta do computador que obteve originalmente o coletor invoque retornos de chamada. Quando a chave do Registro UnsecAppAccessControlDefault é definida como zero, Unsecapp.exe não executa o controle de acesso em retornos de chamada, a menos que CreateSinkStub seja chamado por um aplicativo com o parâmetro dwFlag definido como WBEM_FLAG_UNSECAPP_CHECK_ACCESS. Se o parâmetro não estiver presente, que é o padrão, Unsecapp.exe lerá o valor da chave do Registro para determinar se deseja autenticar retornos de chamada.

Sintaxe

HRESULT CreateSinkStub(
  [in]  IWbemObjectSink *pSink,
  [in]  DWORD           dwFlags,
        LPCWSTR         wszReserved,
  [out] IWbemObjectSink **ppStub
);

Parâmetros

[in] pSink

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

[in] dwFlags

Você pode definir um dos valores a seguir da enumeração WBEM_UNSECAPP_FLAG_TYPE . Esse parâmetro determina como Unsecapp.exe usa a chave do Registro verifica essa chave do Registro:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\WBEM\CIMOM\UnsecAppAccessControlDefault

WBEM_FLAG_UNSECAPP_DEFAULT_CHECK_ACCESS

Unsecapp.exe lê a chave do Registro UnsecAppAccessControlDefault para determinar se ela deve autenticar retornos de chamada.

WBEM_FLAG_UNSECAPP_CHECK_ACCESS

Unsecapp.exe autentica retornos de chamada, independentemente da configuração da chave do Registro UnsecAppAccessControlDefault.

WBEM_FLAG_UNSECAPP_DONT_CHECK_ACCESS

Unsecapp.exe não autentica os retornos de chamada, independentemente da configuração da chave do Registro UnsecAppAccessControlDefault.

wszReserved

Reservado.

[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 .

Valor retornado

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

Esse método é fornecido para melhorar a segurança de chamadas assíncronas de aplicativos cliente. Para obter mais informações, confira Configurar a segurança em uma chamada assíncrona.

Requisitos


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