WdfRequestImpersonate-Funktion (wdfrequest.h)

  • Artikel

[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

Weitere Informationen

EvtRequestImpersonate

IWDFIoRequest::Impersonate