LSA_CONVERT_AUTH_DATA_TO_TOKEN fonction de rappel (ntsecpkg.h)
La fonction ConvertAuthDataToToken crée un jeton d’accès à partir des données d’autorisation retournées par les fonctions GetAuthDataForUser ou GetUserAuthData .
Syntaxe
LSA_CONVERT_AUTH_DATA_TO_TOKEN LsaConvertAuthDataToToken;
NTSTATUS LsaConvertAuthDataToToken(
[in] PVOID UserAuthData,
[in] ULONG UserAuthDataSize,
[in] SECURITY_IMPERSONATION_LEVEL ImpersonationLevel,
[in] PTOKEN_SOURCE TokenSource,
[in] SECURITY_LOGON_TYPE LogonType,
[in] PUNICODE_STRING AuthorityName,
[out] PHANDLE Token,
[out] PLUID LogonId,
[out] PUNICODE_STRING AccountName,
[out] PNTSTATUS SubStatus
)
{...}
Paramètres
[in] UserAuthData
Pointeur vers les données d’autorisation reçues des fonctions GetAuthDataForUser ou GetUserAuthData .
[in] UserAuthDataSize
Taille, en octets, des données d’autorisation spécifiées par le paramètre UserAuthData .
[in] ImpersonationLevel
Valeur SECURITY_IMPERSONATION_LEVEL spécifiant le niveau d’emprunt d’identité pour le jeton à créer.
[in] TokenSource
Pointeur vers une structure TOKEN_SOURCE spécifiant la source à enregistrer dans le jeton.
[in] LogonType
Valeur SECURITY_LOGON_TYPE indiquant le type d’ouverture de session à enregistrer dans le jeton.
[in] AuthorityName
Pointeur vers une structure de UNICODE_STRING qui spécifie le nom de l’autorité qui a autorisé cet utilisateur, généralement un nom de domaine.
[out] Token
Pointeur vers un HANDLE qui reçoit le handle de jeton utilisateur.
Une fois que vous avez terminé d’utiliser le jeton utilisateur, relâchez le handle en appelant CloseHandle.
[out] LogonId
Pointeur vers un LUID qui reçoit l’identificateur d’ouverture de session pour le jeton.
[out] AccountName
Pointeur vers une structure UNICODE_STRING qui reçoit le nom du compte encodé dans le paramètre UserAuthData .
[out] SubStatus
Pointeur vers une variable qui reçoit des informations supplémentaires sur la valeur de retour de l’appel de fonction.
Valeur retournée
Si la fonction réussit, la valeur de retour est STATUS_SUCCESS.
Si la fonction échoue, la valeur de retour est un code NTSTATUS indiquant la raison de son échec.
Remarques
Un pointeur vers la fonction ConvertAuthDataToToken est disponible dans la structure LSA_SECPKG_FUNCTION_TABLE reçue par la fonction SpInitialize .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | ntsecpkg.h |