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 |