IImpersonateCallback::OnImpersonate-Methode (wudfddi.h)
[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF-.]
Die OnImpersonate--Methode behandelt den Identitätswechsel.
Syntax
void OnImpersonate(
[in, optional] void *Context
);
Parameter
[in, optional] Context
Ein Zeiger auf einen Kontext, der zuvor in der IWDFIoRequest::Impersonate-Methode bereitgestellt wurde. Dieser Parameter ist optional und kann NULL- werden, wenn kein Kontext erforderlich ist.
Rückgabewert
Nichts
Bemerkungen
In der Regel verwendet der Treiber diesen Rückruf, um eine Win32-Funktion direkt aufzurufen. Wenn der Treiber beispielsweise eine Datendatei im Auftrag einer Anwendung öffnen muss, die einen E/A-Vorgang gesendet hat, erfordert der Treiber nur den Identitätswechsel, um das Dateihandle zu öffnen.
Um sicherzustellen, dass der Identitätswechsel nicht über Treiberrückruffunktionen oder zwischen Gerätetreibern hinausläuft, sollten OnImpersonate- keine Frameworkmethoden aufrufen.
Ein Treiber registriert die IImpersonateCallback Schnittstelle, wenn der Treiber die IWDFIoRequest::Impersonate-Methode aufruft.
Weitere Informationen dazu, wie UMDF- und UMDF-Treiber Identitätswechsel behandeln, finden Sie unter Umgang mit Identitätswechsel.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Fenster |
| Header- | wudfddi.h (include Wudfddi.h) |