Поделиться через


Функция 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