IAzApplication2 ::InitializeClientContextFromToken2, méthode (azroles.h)

Article
02/23/2024

La méthode InitializeClientContextFromToken2 récupère un pointeur d’objet IAzClientContext2 à partir du jeton client spécifié.

Syntaxe

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

Paramètres

[in] ulTokenHandleLowPart

Octet inférieur d’un handle à un jeton qui spécifie le client. Si les valeurs de ce paramètre et du paramètre ulTokenHandleHighPart sont égales à zéro, le jeton d’emprunt d’identité du thread de l’appelant est utilisé. Si le thread n’a pas de jeton d’emprunt d’identité, le jeton de processus est utilisé. Le jeton doit avoir été ouvert pour un accès TOKEN_QUERY, TOKEN_IMPERSONATE ou TOKEN_DUPLICATE.

[in] ulTokenHandleHighPart

Octet élevé d’un handle à un jeton qui spécifie le client. Si les valeurs de ce paramètre et du paramètre ulTokenHandleHighPart sont égales à zéro, le jeton d’emprunt d’identité du thread de l’appelant est utilisé. Si le thread n’a pas de jeton d’emprunt d’identité, le jeton de processus est utilisé. Le jeton doit avoir été ouvert pour un accès TOKEN_QUERY, TOKEN_IMPERSONATE ou TOKEN_DUPLICATE.

[in, optional] varReserved

Réservé pour un usage futur.

[out] ppClientContext

Pointeur vers un pointeur vers l’objet IAzClientContext2 retourné.

Valeur retournée

Si la méthode réussit, la méthode retourne S_OK.

Si la méthode échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008, Windows Server 2003 avec SP1 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	azroles.h
Bibliothèque	Azroles.lib
DLL	Azroles.dll
Composant redistribuable	Windows Server 2003 Administration Tools Pack sur Windows XP

Partager via