Funzione LookupAccountSidLocalA (winbase.h)

Articolo
08/27/2023

LookupAccountSidLocalA è definito 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 una stringa con terminazione Null contenente il nome dell'account corrispondente al parametro lpSid .

[in, out] cchName

In 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 null di terminazione.

[out, optional] ReferencedDomainName

Puntatore a un buffer che riceve una stringa con terminazione Null 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 il quale 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 Null di terminazione.

[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 informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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	winbase.h (include Windows.h)