IImpersonateCallback::OnImpersonate-Methode (wudfddi.h)

Artikel
03/01/2024

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 in neueren Versionen von Windows 10 ist eingeschränkt. 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 sein, wenn kein Kontext erforderlich ist.

Rückgabewert

Keine

Bemerkungen

In der Regel verwendet der Treiber diesen Rückruf, um eine Win32-Funktion direkt aufzurufen. Wenn der Treiber beispielsweise eine Datendatei im Namen einer Anwendung öffnen muss, die einen E/A-Vorgang gesendet hat, erfordert der Treiber nur einen Identitätswechsel, um das Dateihandle zu öffnen.

Um sicherzustellen, dass der Identitätswechsel nicht über Treiberrückruffunktionen hinweg oder zwischen Gerätetreibern verloren geht, sollte 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 den Identitätswechsel behandeln, finden Sie unter Behandeln von Identitätswechseln.