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. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF-.]
Die Identitätswechsel Methode registriert die Schnittstelle für die Methode, die das Framework für 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-typed-Wert, der die Ebene des Identitätswechsels angibt.
[in] pCallback
Ein Zeiger auf die IImpersonateCallback Schnittstelle, deren Methode das Framework den 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 der IImpersonateCallback::OnImpersonate-Methode. Dieser Parameter ist optional. Der Treiber kann NULL- übergeben, wenn der Treiber keinen Kontext angeben muss.
Rückgabewert
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.
Bemerkungen
Informationen dazu, wie UMDF- und UMDF-Treiber Identitätswechsel behandeln, finden Sie unter Behandeln von Identitätswechsel-.
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform- | Desktop |
| Mindest-UMDF-Version | 1.5 |
| Header- | wudfddi.h (include Wudfddi.h) |
| DLL- | WUDFx.dll |