WdfRequestImpersonate-Funktion (wdfrequest.h)
[Gilt nur für UMDF]
Die WdfRequestImpersonate-Methode registriert eine vom Treiber bereitgestellte Ereignisrückruffunktion, die das Framework für den Identitätswechsel aufrufen sollte.
Syntax
NTSTATUS WdfRequestImpersonate(
[in] WDFREQUEST Request,
[in] SECURITY_IMPERSONATION_LEVEL ImpersonationLevel,
[in] PFN_WDF_REQUEST_IMPERSONATE EvtRequestImpersonate,
[in, optional] PVOID Context
);
Parameter
[in] Request
Ein Handle für das Frameworkanforderungsobjekt, das die E/A-Anforderung darstellt, die abgeschlossen wird.
[in] ImpersonationLevel
Ein SECURITY_IMPERSONATION_LEVEL typisierter Wert, der die Identitätswechselebene angibt.
[in] EvtRequestImpersonate
Ein Zeiger auf die EvtRequestImpersonate-Ereignisrückruffunktion des Treibers.
[in, optional] Context
Ein Zeiger auf einen Puffer, der Kontextinformationen enthält, die sich auf den Identitätswechselaufruf beziehen. Das Framework übergibt diese Kontextinformationen in einem Aufruf der Ereignisrückruffunktion EvtRequestImpersonate . Dieser Parameter ist optional und kann NULL sein.
Rückgabewert
Wenn bei der WdfRequestImpersonate-Methode keine Fehler auftreten, wird STATUS_SUCCESS zurückgegeben.
Die -Methode gibt möglicherweise andere NTSTATUS-Werte zurück.
Hinweise
Die WdfRequestImpersonate-Methode gibt erst zurück, wenn die Ereignisrückruffunktion EvtRequestImpersonate abgeschlossen ist.
Weitere Informationen finden Sie unter Behandeln von Clientidentitätswechseln in UMDF-Treibern.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8.1 |
| Zielplattform | Universell |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdfrequest.h (include Wdf.h) |
| Bibliothek | WUDFx02000.lib |
| DLL | WUDFx02000.dll |
| IRQL | PASSIVE_LEVEL |