LSA_OPEN_SAM_USER funzione di callback (ntsecpkg.h)

  • Articolo

Recupera un handle a un account utente nel database Di Gestione account di sicurezza (SAM).

Sintassi

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

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. Questo valore viene usato con il parametro Prefisso .
SecNameFlat
 Nome è un nome dell'entità utente flat (UPN)-style account name.
SecNameDN
 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.

Valore Significato
FALSE
 Se l'utente non viene trovato, la chiamata di funzione OpenSamUser ha esito negativo.
TRUE
 Se l'utente non viene trovato e l'account Guest è abilitato, viene usato l'account Guest.

[in] Reserved

Riservato. Specificare zero.

[out] UserHandle

Puntatore a un puntatore che riceve un handle all'account utente.

Valore restituito

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
STATUS_INVALID_PARAMETER
 NameType è SecNameAlternateId e Il prefisso è NULL.
STATUS_NO_SUCH_USER
 Impossibile trovare l'account SAM.

Commenti

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 .

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

LSA_SECPKG_FUNCTION_TABLE

SpInitialize