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

Статья
11/20/2024

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-terminated string, содержащий имя учетной записи, соответствующее параметру lpSid.

[in, out] cchName

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

[out, optional] ReferencedDomainName

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

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

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

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

[in, out] cchReferencedDomainName

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

[out] peUse

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

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

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

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

Замечания

Эта функция похожа на LookupAccountSid, но ограничивает поиск на локальном компьютере.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	winbase.h (включая Windows.h)