IWDFIoRequest::Impersonate-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. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 für neuere 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 Impersonate-Methode registriert die Schnittstelle für die Methode, die das Framework für den Identitätswechsel aufrufen soll.

Syntax

HRESULT Impersonate(
  [in]           SECURITY_IMPERSONATION_LEVEL ImpersonationLevel,
  [in]           IImpersonateCallback         *pCallback,
  [in, optional] void                         *pvCallbackContext
);

Parameter

[in] ImpersonationLevel

Ein SECURITY_IMPERSONATION_LEVEL typisierter Wert, der die Ebene des Identitätswechsels angibt.

[in] pCallback

Ein Zeiger auf die IImpersonateCallback-Schnittstelle , deren Methode das Framework zum Identitätswechsel aufruft.

[in, optional] pvCallbackContext

Ein Zeiger auf einen Puffer, der Kontextinformationen enthält, die sich auf den Identitätswechselaufruf beziehen. Das Framework übergibt diese Kontextinformationen in einem Aufruf an die IImpersonateCallback::OnImpersonate-Methode . Dieser Parameter ist optional. Der Treiber kann NULL übergeben, wenn der Treiber keinen Kontext angeben muss.

Rückgabewert

Der Identitätswechsel gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode einen der Fehlercodes zurück, die in Winerror.h definiert sind.

Hinweise

Informationen dazu, wie UMDF- und UMDF-Treiber den Identitätswechsel behandeln, finden Sie unter Behandeln des Identitätswechsels.

Anforderungen

Anforderung	Wert
Ende des Supports	In UMDF 2.0 und höher nicht verfügbar.
Zielplattform	Desktop
UMDF-Mindestversion	1.5
Kopfzeile	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

Weitere Informationen

IImpersonateCallback

IImpersonateCallback::OnImpersonate

IWDFIoRequest

SECURITY_IMPERSONATION_LEVEL