Функция LookupAccountSidLocalA (winbase.h)

Статья
03/08/2023

LookupAccountSidLocalA определяется как макрос, который вызывает LookupAccountSidA с NULL в качестве первого параметра. Извлекает имя учетной записи для указанного идентификатора безопасности на локальном компьютере.

Синтаксис

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
);

Параметры

[in] Sid

Указатель на ИД безопасности для поиска.

[out, optional] Name

Указатель на буфер, получающий строку, завершающуюся значением NULL, которая содержит имя учетной записи, соответствующее параметру lpSid .

[in, out] cchName

На входных данных указывает размер буфера lpName в TCHAR. Если функция завершается ошибкой из-за слишком малого буфера или если значение cchName равно нулю, cchName получает требуемый размер буфера, включая завершающий символ NULL .

[out, optional] ReferencedDomainName

Указатель на буфер, получающий строку, завершающуюся значением NULL, которая содержит имя домена, в котором было найдено имя учетной записи.

На сервере для большинства учетных записей в базе данных безопасности локального компьютера возвращается доменное имя, для которого сервер является контроллером домена.

На рабочей станции доменное имя, возвращаемое для большинства учетных записей в базе данных безопасности локального компьютера, является именем компьютера с последнего запуска системы (обратные косые косые скобки исключаются). Если имя компьютера меняется, старое имя продолжает возвращаться в качестве доменного имени до перезагрузки системы.

Некоторые учетные записи предопределяются системой. Для этих учетных записей возвращается доменное имя BUILTIN.

[in, out] cchReferencedDomainName

На входных данных указывает размер буфера lpReferencedDomainName в TCHAR. Если функция завершается сбоем из-за слишком малого буфера или если значение cchReferencedDomainName равно нулю, cchReferencedDomainName получает требуемый размер буфера, включая завершающий символ NULL .

[out] peUse

Указатель на переменную, получающую SID_NAME_USE значение, указывающее тип учетной записи.

Возвращаемое значение

Если функция выполнена успешно, функция возвращает ненулевое значение.

Если функция завершается сбоем, она возвращает ноль. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Заголовок winbase.h определяет LookupAccountSidLocal в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	winbase.h (включая Windows.h)