Функция LookupAccountSidLocalA (winbase.h)
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.
Комментарии
Эта функция похожа на LookupAccountSid, но ограничивает поиск только локальным компьютером.
Примечание
Заголовок winbase.h определяет LookupAccountSidLocal в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows XP [только классические приложения] |
Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
Целевая платформа | Windows |
Header | winbase.h (включая Windows.h) |