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

Artículo
08/27/2023

El método CreateSinkStub es similar al IUnsecuredApartment::CreateObjectStub y crea un receptor del reenviador de objetos y realiza comprobaciones de acceso para recibir llamadas asincrónicas de administración de Windows. CreateSinkStub difiere de CreateObjectStub porque puede especificar que se deben autenticar las devoluciones de llamada al receptor.

WMI proporciona el proceso de Unsecapp.exe para funcionar como proceso independiente. Puede hospedar Unsecapp.exe con una llamada a la interfaz IWbemUnsecuredApartment o a la interfaz IUnsecuredApartment en otras versiones de Windows. IUnsecuredApartment no tiene ningún método que realice la comprobación de acceso.

Una comprobación de acceso significa que Unsecapp.exe solo permite que la cuenta del equipo que obtuvo originalmente el receptor invoque devoluciones de llamada. Cuando la clave del Registro UnsecAppAccessControlDefault se establece en cero, Unsecapp.exe no realiza el control de acceso en las devoluciones de llamada a menos que una aplicación llame a CreateSinkStub con el parámetro dwFlag establecido en WBEM_FLAG_UNSECAPP_CHECK_ACCESS. Si el parámetro no está presente, que es el valor predeterminado, Unsecapp.exe lee el valor de clave del Registro para determinar si se autentican las devoluciones de llamada.

Sintaxis

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

Parámetros

[in] pSink

Puntero a la implementación en proceso del cliente de IWbemObjectSink.

[in] dwFlags

Puede establecer uno de los siguientes valores de WBEM_UNSECAPP_FLAG_TYPE enumeración. Este parámetro determina cómo Unsecapp.exe usa la clave del Registro comprueba esta clave del Registro:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\WBEM\CIMOM\UnsecAppAccessControlDefault

WBEM_FLAG_UNSECAPP_DEFAULT_CHECK_ACCESS

Unsecapp.exe lee la clave del Registro UnsecAppAccessControlDefault para determinar si debe autenticar devoluciones de llamada.

WBEM_FLAG_UNSECAPP_CHECK_ACCESS

Unsecapp.exe autentica las devoluciones de llamada independientemente de la configuración de la clave del Registro UnsecAppAccessControlDefault.

WBEM_FLAG_UNSECAPP_DONT_CHECK_ACCESS

Unsecapp.exe no autentica las devoluciones de llamada independientemente de la configuración de la clave del Registro UnsecAppAccessControlDefault.

wszReserved

Reservado.

[out] ppStub

Recibe un puntero a un objeto sustituto que se usará en llamadas asincrónicas de IWbemServices . El usuario recibe un puntero IUnknown y debe llamar a QueryInterface para IID_WbemObjectSink antes de usar este objeto en llamadas asincrónicas de IWbemServices .

Valor devuelto

Este método devuelve códigos de error COM estándar para QueryInterface. Devuelve S_OK si la llamada se realiza correctamente. Si se produce un error en la llamada porque no se admite la interfaz solicitada, el método devuelve E_NOINTERFACE.

También se pueden devolver códigos de error específicos de COM si los problemas de red hacen que pierda la conexión remota a administración de Windows.

Comentarios

Este método se proporciona para mejorar la seguridad de las llamadas asincrónicas de las aplicaciones cliente. Para más información, consulte Establecimiento de la seguridad en una llamada asincrónica.

Requisitos


Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	wbemcli.h (include Wbemidl.h)
Library	Wbemuuid.lib
Archivo DLL	Unsecapp.exe