Partager via


IWDFIoRequest ::Impersonate, méthode (wudfddi.h)

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

L’emprunt d’identité méthode 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 SECURITY_IMPERSONATION_LEVEL-typée qui identifie le niveau d’emprunt d’identité.

[in] pCallback

Pointeur vers l’interface IImpersonateCallback dont la méthode appelle 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é. Le framework transmet ces informations de contexte dans un appel à la méthode IImpersonateCallback ::OnImpersonate. Ce paramètre est facultatif. Le pilote peut passer NULL si le pilote n’a pas besoin de fournir un contexte.

Valeur de retour

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

Exigences

Exigence Valeur
fin du support Indisponible dans UMDF 2.0 et versions ultérieures.
plateforme cible Bureau
version minimale de UMDF 1.5
d’en-tête wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll

Voir aussi

IImpersonateCallback

IImpersonateCallback ::OnImpersonate

IWDFIoRequest

SECURITY_IMPERSONATION_LEVEL