Функция GetSidIdentifierAuthority (securitybaseapi.h)

Функция GetSidIdentifierAuthority возвращает указатель на структуру SID_IDENTIFIER_AUTHORITY в указанном идентификаторе безопасности (SID).

Синтаксис

PSID_IDENTIFIER_AUTHORITY GetSidIdentifierAuthority(
  [in] PSID pSid
);

Параметры

[in] pSid

Указатель на структуру SID , для которой возвращается указатель на структуру SID_IDENTIFIER_AUTHORITY .

Эта функция не обрабатывает недопустимые структуры идентификаторов безопасности . Прежде чем вызывать эту функцию, вызовите функцию IsValidSid , чтобы убедиться, что структура ИД безопасности действительна.

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

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

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

Комментарии

Эта функция использует 32-разрядное значение RID. Для приложений, которым требуется большее значение RID, используйте CreateWellKnownSid и связанные функции.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	securitybaseapi.h (включая Windows.h)
Библиотека	Advapi32.lib
DLL	Advapi32.dll

См. также раздел

Обзор контроль доступа

Базовые функции контроль доступа

CreateWellKnownSid

GetLengthSid

GetSidLengthRequired

GetSidSubAuthority

GetSidSubAuthorityCount

IsValidSid

SID

SID_IDENTIFIER_AUTHORITY