LSA_GET_AUTH_DATA_FOR_USER funzione di callback (ntsecpkg.h)
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 |
---|---|
|
Il nome è compatibile con SAM. Un esempio di nome nel formato compatibile con SAM è "ExampleDomain\Username". |
|
Name è nella proprietà AltSecId dell'account SAM. È necessario specificare un valore per il parametro Prefisso quando si usa questo valore. |
|
Nome è un nome account di stile UPN ( Flat User Principal Name). |
|
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 |