IImpersonateCallback ::OnImpersonate, 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.]
La méthode OnImpersonate gère l’emprunt d’identité.
Syntaxe
void OnImpersonate(
[in, optional] void *Context
);
Paramètres
[in, optional] Context
Pointeur vers un contexte précédemment fourni dans la méthode IWDFIoRequest ::Impersonate. Ce paramètre est facultatif et peut être NULL si un contexte n’est pas obligatoire.
Valeur de retour
Aucun
Remarques
En règle générale, le pilote utilise ce rappel pour appeler directement une fonction Win32. Par exemple, si le pilote doit ouvrir un fichier de données pour le compte d’une application qui a envoyé une opération d’E/S, le pilote nécessite l’emprunt d’identité uniquement pour ouvrir le handle de fichier.
Pour vous assurer que l’emprunt d’identité ne fuit pas entre les fonctions de rappel du pilote ou entre les pilotes de périphérique, OnImpersonate ne doit pas appeler de méthodes d’infrastructure.
Un pilote inscrit l’interface IImpersonateCallback lorsque le pilote appelle la méthode IWDFIoRequest ::Impersonate.
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 |
|---|---|
| plateforme cible | Windows |
| d’en-tête | wudfddi.h (include Wudfddi.h) |