WdfRequestImpersonate, fonction (wdfrequest.h)

  • Article

[S’applique à UMDF uniquement]

La méthode WdfRequestImpersonate enregistre une fonction de rappel d’événement fournie par le pilote que l’infrastructure doit appeler pour l’emprunt d’identité.

Syntaxe

NTSTATUS WdfRequestImpersonate(
  [in]           WDFREQUEST                   Request,
  [in]           SECURITY_IMPERSONATION_LEVEL ImpersonationLevel,
  [in]           PFN_WDF_REQUEST_IMPERSONATE  EvtRequestImpersonate,
  [in, optional] PVOID                        Context
);

Paramètres

[in] Request

Handle de l’objet de demande d’infrastructure qui représente la demande d’E/S en cours d’exécution.

[in] ImpersonationLevel

Valeur SECURITY_IMPERSONATION_LEVEL typée qui identifie le niveau d’emprunt d’identité.

[in] EvtRequestImpersonate

Pointeur vers la fonction de rappel d’événement EvtRequestImpersonate du pilote.

[in, optional] Context

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 fonction de rappel d’événement EvtRequestImpersonate . Ce paramètre est facultatif et peut être NULL

Valeur retournée

Si la méthode WdfRequestImpersonate ne rencontre aucune erreur, elle retourne STATUS_SUCCESS.

La méthode peut retourner d’autres valeurs NTSTATUS.

Remarques

La méthode WdfRequestImpersonate ne retourne pas tant que la fonction de rappel d’événement EvtRequestImpersonate n’est pas terminée.

Pour plus d’informations, consultez Gestion de l’emprunt d’identité client dans les pilotes UMDF.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8.1
Plateforme cible Universal
Version UMDF minimale 2.0
En-tête wdfrequest.h (inclure Wdf.h)
Bibliothèque WUDFx02000.lib
DLL WUDFx02000.dll
IRQL PASSIVE_LEVEL

Voir aussi

EvtRequestImpersonate

IWDFIoRequest ::Impersonate