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

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

Confira também

IUnsecuredApartment::CreateObjectStub

IWbemUnsecuredApartment

Reduzir a segurança de um coletor em um processo separado

Executar verificações de acesso

Configurar a segurança em uma chamada assíncrona