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

Article
08/27/2023

La méthode CreateSinkStub est similaire à IUnsecuredApartment::CreateObjectStub et crée un récepteur de redirecteur d’objets et effectue des vérifications d’accès pour la réception d’appels asynchrones à partir de Windows Management. CreateSinkStub diffère de CreateObjectStub , car il peut spécifier que les rappels au récepteur doivent être authentifiés.

WMI fournit le processus Unsecapp.exe pour fonctionner en tant que processus distinct. Vous pouvez héberger Unsecapp.exe avec un appel à l’interface IWbemUnsecuredApartment ou IUnsecuredApartment dans d’autres versions de Windows. IUnsecuredApartment n’a pas de méthodes qui effectuent la vérification d’accès.

Un case activée d’accès signifie que Unsecapp.exe autorise uniquement le compte de l’ordinateur qui a obtenu le récepteur à l’origine à appeler des rappels. Lorsque la clé de Registre UnsecAppAccessControlDefault est définie sur zéro, Unsecapp.exe n’effectue pas de contrôle d’accès sur les rappels, sauf si CreateSinkStub est appelé par une application avec le paramètre dwFlag défini sur WBEM_FLAG_UNSECAPP_CHECK_ACCESS. Si le paramètre n’est pas présent, ce qui est la valeur par défaut, Unsecapp.exe lit la valeur de clé de Registre pour déterminer s’il faut authentifier les rappels.

Syntaxe

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

Paramètres

[in] pSink

Pointeur vers l’implémentation in-process du client d’IWbemObjectSink.

[in] dwFlags

Vous pouvez définir l’une des valeurs suivantes à partir de WBEM_UNSECAPP_FLAG_TYPE énumération. Ce paramètre détermine comment Unsecapp.exe utilise la clé de Registre vérifie cette clé de Registre :

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\WBEM\CIMOM\UnsecAppAccessControlDefault

WBEM_FLAG_UNSECAPP_DEFAULT_CHECK_ACCESS

Unsecapp.exe lit la clé de Registre UnsecAppAccessControlDefault pour déterminer s’il doit authentifier les rappels.

WBEM_FLAG_UNSECAPP_CHECK_ACCESS

Unsecapp.exe authentifie les rappels quel que soit le paramètre de la clé de Registre UnsecAppAccessControlDefault.

WBEM_FLAG_UNSECAPP_DONT_CHECK_ACCESS

Unsecapp.exe n’authentifie pas les rappels, quel que soit le paramètre de la clé de Registre UnsecAppAccessControlDefault.

wszReserved

Réservé.

[out] ppStub

Reçoit un pointeur vers un objet de remplacement à utiliser dans les appels IWbemServices asynchrones. L’utilisateur reçoit un pointeur IUnknown et doit appeler QueryInterface pour IID_WbemObjectSink avant d’utiliser cet objet dans les appels IWbemServices asynchrones.

Valeur retournée

Cette méthode retourne des codes d’erreur COM standard pour QueryInterface. Il retourne S_OK si l’appel réussit. Si l’appel échoue parce que l’interface demandée n’était pas prise en charge, la méthode retourne E_NOINTERFACE.

Des codes d’erreur spécifiques à COM peuvent également être retournés si des problèmes réseau vous font perdre la connexion à distance à Windows Management.

Remarques

Cette méthode est fournie pour améliorer la sécurité des appels asynchrones à partir d’applications clientes. Pour plus d’informations, consultez Définition de la sécurité sur un appel asynchrone.

Spécifications


Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	wbemcli.h (inclure Wbemidl.h)
Bibliothèque	Wbemuuid.lib
DLL	Unsecapp.exe