Eventi
19 nov, 23 - 21 nov, 23
Ottenere il vantaggio competitivo necessario con potenti soluzioni di intelligenza artificiale e cloud partecipando a Microsoft Ignite online.
Iscriviti subitoQuesto browser non è più supportato.
Esegui l'aggiornamento a Microsoft Edge per sfruttare i vantaggi di funzionalità più recenti, aggiornamenti della sicurezza e supporto tecnico.
Recupera un handle a un account utente nel database Di Gestione account di sicurezza (SAM).
LSA_OPEN_SAM_USER LsaOpenSamUser;
NTSTATUS LsaOpenSamUser(
[in] PSECURITY_STRING Name,
[in] SECPKG_NAME_TYPE NameType,
[in] PSECURITY_STRING Prefix,
[in] BOOLEAN AllowGuest,
[in] ULONG Reserved,
[out] PVOID *UserHandle
)
{...}
[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. Questo valore viene usato con il parametro Prefisso . |
|
Nome è un nome dell'entità utente flat (UPN)-style account name. |
|
Nome è il nome distinto dell'oggetto. Per altre informazioni, vedere la sezione Osservazioni. |
[in] Prefix
Puntatore a una struttura UNICODE_STRING che specifica il prefisso da usare con nomi che usano un NameType di SecNameAlternateId.
[in] AllowGuest
Specifica se usare l'account Guest se l'account SAM non viene trovato. Questo parametro può avere uno dei valori seguenti.
[in] Reserved
Riservato. Specificare zero.
[out] UserHandle
Puntatore a un puntatore che riceve un handle all'account utente.
Se la funzione ha esito positivo, il valore restituito è STATUS_SUCCESS.
Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore NTSTATUS seguenti che indicano il motivo dell'errore.
Codice restituito | Descrizione |
---|---|
|
NameType è SecNameAlternateId e Il prefisso è NULL. |
|
Impossibile trovare l'account SAM. |
Per chiudere l'handle ricevuto dal parametro UserHandle , chiamare la funzione CloseSamUser .
Il nome distinto di un utente identifica il nome, il dominio e il percorso completo dell'oggetto Active Directory che rappresenta l'utente.
Un puntatore alla funzione OpenSamUser è disponibile nella struttura LSA_SECPKG_FUNCTION_TABLE ricevuta dalla funzione SpInitialize .
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 |
Eventi
19 nov, 23 - 21 nov, 23
Ottenere il vantaggio competitivo necessario con potenti soluzioni di intelligenza artificiale e cloud partecipando a Microsoft Ignite online.
Iscriviti subito