Funzione LookupAccountSidLocalA (winbase.h)

Articolo
11/20/2024

LookupAccountSidLocalA viene definita come macro che chiama LookupAccountSidA con NULL come primo parametro. Recupera il nome dell'account per il SID specificato nel computer locale.

Sintassi

BOOL LookupAccountSidLocalA(
  [in]            PSID          Sid,
  [out, optional] LPSTR         Name,
  [in, out]       LPDWORD       cchName,
  [out, optional] LPSTR         ReferencedDomainName,
  [in, out]       LPDWORD       cchReferencedDomainName,
  [out]           PSID_NAME_USE peUse
);

Parametri

[in] Sid

Puntatore al SID da cercare.

[out, optional] Name

Puntatore a un buffer che riceve un nullstringa con terminazione contenente il nome dell'account corrispondente al parametro lpSid.

[in, out] cchName

In caso di input, specifica le dimensioni, in TCHARs, del buffer lpName . Se la funzione ha esito negativo perché il buffer è troppo piccolo o se cchName è zero, cchName riceve le dimensioni del buffer necessarie, incluso il carattere di terminazione null.

[out, optional] ReferencedDomainName

Puntatore a un buffer che riceve un nullstringa con terminazione contenente il nome del dominio in cui è stato trovato il nome dell'account.

In un server, il nome di dominio restituito per la maggior parte degli account nel database di sicurezza del computer locale è il nome del dominio per cui il server è un controller di dominio.

In una workstation, il nome di dominio restituito per la maggior parte degli account nel database di sicurezza del computer locale è il nome del computer a partire dall'ultimo avvio del sistema (le barre rovesciate sono escluse). Se il nome del computer cambia, il nome precedente continua a essere restituito come nome di dominio fino al riavvio del sistema.

Alcuni account sono predefiniti dal sistema. Il nome di dominio restituito per questi account è BUILTIN.

[in, out] cchReferencedDomainName

In input, specifica le dimensioni, in TCHARs, del buffer lpReferencedDomainName. Se la funzione ha esito negativo perché il buffer è troppo piccolo o se cchReferencedDomainName è zero, cchReferencedDomainName riceve le dimensioni del buffer necessarie, incluso il carattere di terminazione null.

[out] peUse

Puntatore a una variabile che riceve un valore SID_NAME_USE che indica il tipo di account.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce un valore diverso da zero.

Se la funzione ha esito negativo, restituisce zero. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

Questa funzione è simile a LookupAccountSid, ma limita la ricerca al computer locale.

Nota

L'intestazione winbase.h definisce LookupAccountSidLocal come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winbase.h (include Windows.h)