LSA_OPEN_SAM_USER funzione di callback (ntsecpkg.h)

Articolo
03/05/2024

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

Condividi tramite