Funzione LookupAccountSidLocalW (winbase.h)

Articolo
03/13/2024

LookupAccountSidLocalW è definita come macro che chiama LookupAccountSidW con NULL come primo parametro. Recupera il nome dell'account per il SID specificato nel computer locale.

Sintassi

BOOL LookupAccountSidLocalW(
  [in]            PSID          Sid,
  [out, optional] LPWSTR        Name,
  [in, out]       LPDWORD       cchName,
  [out, optional] LPWSTR        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 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 inizio 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 dell'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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

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)