Méthode IImpersonateCallback ::OnImpersonate (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 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 avoir la valeur NULL si un contexte n’est pas requis.
Valeur de retour
None
Remarques
En règle générale, le pilote utilise ce rappel pour appeler une fonction Win32 directement. 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 garantir que l’emprunt d’identité ne fuit pas entre les fonctions de rappel des pilotes 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é.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | wudfddi.h (inclure Wudfddi.h) |