Partager via

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

  • Article

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