IAzApplication2::InitializeClientContextFromToken2-Methode (azroles.h)

Artikel
02/23/2024

Die InitializeClientContextFromToken2-Methode ruft einen IAzClientContext2-Objektzeiger aus dem angegebenen Clienttoken ab.

Syntax

HRESULT InitializeClientContextFromToken2(
  [in]           ULONG             ulTokenHandleLowPart,
  [in]           ULONG             ulTokenHandleHighPart,
  [in, optional] VARIANT           varReserved,
  [out]          IAzClientContext2 **ppClientContext
);

Parameter

[in] ulTokenHandleLowPart

Niedriges Byte eines Handles für ein Token, das den Client angibt. Wenn die Werte sowohl dieses Parameters als auch des ulTokenHandleHighPart-Parameters null sind, wird das Identitätswechseltoken des Aufrufersthreads verwendet. Wenn der Thread kein Identitätswechseltoken aufweist, wird das Prozesstoken verwendet. Das Token muss für den zugriff auf TOKEN_QUERY, TOKEN_IMPERSONATE oder TOKEN_DUPLICATE geöffnet worden sein.

[in] ulTokenHandleHighPart

Hohes Byte eines Handles für ein Token, das den Client angibt. Wenn die Werte sowohl dieses Parameters als auch des ulTokenHandleHighPart-Parameters null sind, wird das Identitätswechseltoken des Aufrufersthreads verwendet. Wenn der Thread kein Identitätswechseltoken aufweist, wird das Prozesstoken verwendet. Das Token muss für den zugriff auf TOKEN_QUERY, TOKEN_IMPERSONATE oder TOKEN_DUPLICATE geöffnet worden sein.

[in, optional] varReserved

Für die zukünftige Verwendung reserviert.

[out] ppClientContext

Ein Zeiger auf einen Zeiger auf das zurückgegebene IAzClientContext2-Objekt .

Rückgabewert

Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück.

Wenn die Methode fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008, Windows Server 2003 mit SP1 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	azroles.h
Bibliothek	Azroles.lib
DLL	Azroles.dll
Verteilbare Komponente	Windows Server 2003 Administration Tools Pack unter Windows XP

Share via