UDF > WinAPIEx > Processes & Synchronization > Processes >


_WinAPI_DuplicateTokenEx

Crée un nouveau jeton d'accès primaire ou impersonnel qui reproduit un jeton existant

#include <WinAPIProc.au3>
_WinAPI_DuplicateTokenEx ( $hToken, $iAccess, $iLevel [, $iType = 1 [, $tSecurity = 0]] )

Paramètres

$hToken Le handle du jeton d'accès ouvert avec un accès $TOKEN_DUPLICATE.
$iAccess Les droits d'accès demandés pour le nouveau jeton. Pour obtenir les mêmes droits d'accès que le jeton existant, spécifiez zéro.
Pour demander tous les droits d'accès qui sont valables pour l'appelant, spécifiez l'accès $TOKEN_ALL_ACCESS.
$iLevel Le niveau de sécurité pour un jeton impersonnel.
    $SECURITYANONYMOUS
    $SECURITYIDENTIFICATION
    $SECURITYIMPERSONATION
    $SECURITYDELEGATION
$iType [optionnel] Le type de jeton.
    $TOKENPRIMARY
    $TOKENIMPERSONATION
$tSecurity [optionnel] Structure $tagSECURITY_ATTRIBUTES qui spécifie un descripteur de sécurité pour le nouveau jeton et qui détermine si les processus enfants peuvent hériter le jeton.
Si ce paramètre est 0 (par défaut), le jeton obtient un descripteur de sécurité par défaut et le handle ne peut pas être hérité.
Si le descripteur de sécurité contient une liste de contrôle d'accès au système, le jeton obtient le droit d'accès $ACCESS_SYSTEM_SECURITY, même il n'a pas été demandé.

Valeur de retour

Succès: Retourne le handle du nouveau jeton.
Échec: Retourne 0, appelez _WinAPI_GetLastError() pour obtenir des informations supplémentaires sur l'erreur.

Remarque

Lorsque vous avez fini d'utiliser le nouveau jeton, appelez la fonction _WinAPI_CloseHandle() pour fermer le handle du jeton.

En relation

_WinAPI_CloseHandle

Voir aussi

Consultez DuplicateTokenEx dans la librairie MSDN.