WdfRequestImpersonate, fonction (wdfrequest.h)
[S’applique uniquement à UMDF]
La méthode WdfRequestImpersonate inscrit 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 requête de framework qui représente la requête 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 de retour
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 se termine.
Pour plus d’informations, consultez Gestion de l’emprunt d’identité du client dans les pilotes UMDF.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 8.1 |
| plateforme cible | Universel |
| version minimale de UMDF | 2.0 |
| d’en-tête | wdfrequest.h (include Wdf.h) |
| bibliothèque | WUDFx02000.lib |
| DLL | WUDFx02000.dll |
| IRQL | PASSIVE_LEVEL |