LSA_CONVERT_AUTH_DATA_TO_TOKEN funzione di callback (ntsecpkg.h)

Articolo
02/29/2024

La funzione ConvertAuthDataToToKen crea un token di accesso dai dati di autorizzazione restituiti dalle funzioni GetAuthDataForUser o GetUserAuthData .

Sintassi

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
)
{...}

Parametri

[in] UserAuthData

Puntatore ai dati di autorizzazione ricevuti dalle funzioni GetAuthDataForUser o GetUserAuthData .

[in] UserAuthDataSize

Dimensioni, in byte, dei dati di autorizzazione specificati dal parametro UserAuthData .

[in] ImpersonationLevel

Valore SECURITY_IMPERSONATION_LEVEL che specifica il livello di rappresentazione per il token da creare.

[in] TokenSource

Puntatore a una struttura TOKEN_SOURCE che specifica l'origine da registrare nel token.

[in] LogonType

Valore SECURITY_LOGON_TYPE che indica il tipo di accesso da registrare nel token.

[in] AuthorityName

Puntatore a una struttura UNICODE_STRING che specifica il nome dell'autorità che ha autorizzato l'utente, in genere un nome di dominio.

[out] Token

Puntatore a un handle che riceve l'handle del token utente.

Al termine dell'uso del token utente, rilasciare l'handle chiamando CloseHandle.

[out] LogonId

Puntatore a un LUID che riceve l'identificatore di accesso per il token.

[out] AccountName

Puntatore a una struttura UNICODE_STRING che riceve il nome dell'account codificato nel parametro UserAuthData .

[out] SubStatus

Puntatore a una variabile che riceve informazioni aggiuntive sul valore restituito della chiamata di funzione.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene STATUS_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice NTSTATUS che indica il motivo per cui non è riuscito.

Commenti

Un puntatore alla funzione ConvertAuthDataToToToken è disponibile nella struttura LSA_SECPKG_FUNCTION_TABLE ricevuta dalla funzione SpInitialize .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ntsecpkg.h