Méthode IWDFIoRequest ::Impersonate (wudfddi.h)

[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]

La méthode Impersonate inscrit l’interface de la méthode que l’infrastructure doit appeler pour l’emprunt d’identité.

Syntaxe

HRESULT Impersonate(
  [in]           SECURITY_IMPERSONATION_LEVEL ImpersonationLevel,
  [in]           IImpersonateCallback         *pCallback,
  [in, optional] void                         *pvCallbackContext
);

Paramètres

[in] ImpersonationLevel

Valeur de type SECURITY_IMPERSONATION_LEVEL qui identifie le niveau d’emprunt d’identité.

[in] pCallback

Pointeur vers l’interface IImpersonateCallback dont l’infrastructure appelle la méthode pour l’emprunt d’identité.

[in, optional] pvCallbackContext

Pointeur vers une mémoire tampon qui contient des informations de contexte liées à l’appel d’emprunt d’identité. L’infrastructure transmet ces informations de contexte dans un appel à la méthode IImpersonateCallback ::OnImpersonate . Ce paramètre est facultatif. Le pilote peut passer la valeur NULL si le pilote n’a pas besoin de fournir un contexte.

Valeur retournée

L’emprunt d’identité retourne S_OK si l’opération réussit. Sinon, cette méthode retourne l’un des codes d’erreur définis dans Winerror.h.

Remarques

Pour plus d’informations sur la façon dont les pilotes UMDF et UMDF gèrent l’emprunt d’identité, consultez Gestion de l’emprunt d’identité.

Configuration requise

Voir aussi

IImpersonateCallback

IImpersonateCallback ::OnImpersonate

IWDFIoRequest

SECURITY_IMPERSONATION_LEVEL