LSA_GET_AUTH_DATA_FOR_USER funzione di callback (ntsecpkg.h)

  • Articolo

La funzione GetAuthDataForUser recupera le informazioni di autenticazione per un utente dal database SAM (Security Accounts Manager) e la inserisce in un formato adatto per la funzione ConvertAuthDataToToken .

Sintassi

LSA_GET_AUTH_DATA_FOR_USER LsaGetAuthDataForUser;

NTSTATUS LsaGetAuthDataForUser(
  [in]  PSECURITY_STRING Name,
  [in]  SECPKG_NAME_TYPE NameType,
  [in]  PSECURITY_STRING Prefix,
  [out] PUCHAR *UserAuthData,
  [out] PULONG UserAuthDataSize,
  [out] PUNICODE_STRING UserFlatName
)
{...}

Parametri

[in] Name

Puntatore a una struttura UNICODE_STRING che specifica il nome dell'account SAM.

[in] NameType

Valore di enumerazione SECPKG_NAME_TYPE che specifica il tipo di nome dell'account in Nome. Questo parametro può avere uno dei valori seguenti.

Valore Significato
SecNameSamCompatible
 Il nome è compatibile con SAM. Un esempio di nome nel formato compatibile con SAM è "ExampleDomain\Username".
SecNameAlternateId
 Name è nella proprietà AltSecId dell'account SAM. È necessario specificare un valore per il parametro Prefisso quando si usa questo valore.
SecNameFlat
 Nome è un nome account di stile UPN ( Flat User Principal Name).
SecNameDN
 Nome è il nome distinto dell'oggetto. Per altre informazioni, vedere la sezione Osservazioni.

[in] Prefix

Puntatore a una struttura UNICODE_STRING contenente il prefisso da usare per i nomi specificati con SecNameAlternateIdNameType.

[out] UserAuthData

Puntatore che riceve l'indirizzo dei dati recuperati.

[out] UserAuthDataSize

Puntatore a un ULONG che riceve le dimensioni dei dati recuperati.

[out] UserFlatName

Puntatore a una struttura UNICODE_STRING che riceve l'UPN, se applicabile.

Valore restituito

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

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

Commenti

La funzione GetAuthDataForUser combina le funzioni OpenSamUser, GetUserAuthData e CloseSamUser in una sola chiamata.

I puntatori a queste funzioni sono disponibili 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

Vedi anche

CloseSamUser

GetUserAuthData

LSA_SECPKG_FUNCTION_TABLE

OpenSamUser

SpInitialize