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

Статья
08/25/2023

Функция GetSidSubAuthority возвращает указатель на указанную подавторитетность в идентификаторе безопасности (SID). Значение вложенной проверки подлинности является относительным идентификатором (RID).

Синтаксис

PDWORD GetSidSubAuthority(
  [in] PSID  pSid,
  [in] DWORD nSubAuthority
);

Параметры

[in] pSid

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

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

[in] nSubAuthority

Задает значение индекса, определяющее элемент массива подавторитетности, адрес которого будет возвращен функцией. Функция не выполняет проверочные тесты для этого значения. Приложение может вызвать функцию GetSidSubAuthorityCount , чтобы обнаружить диапазон допустимых значений.

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

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

Если функция завершается сбоем, возвращаемое значение не определено. Функция завершается ошибкой, если указанная структура sid недопустима или значение индекса, заданное параметром nSubAuthority , выходит за пределы.

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

Требования

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