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

Статья
08/25/2023

Функция GetSidSubAuthorityCount возвращает указатель на член в структуре идентификатора безопасности (SID), которая содержит счетчик вложенного удостоверений.

Синтаксис

PUCHAR GetSidSubAuthorityCount(
  [in] PSID pSid
);

Параметры

[in] pSid

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

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

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

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

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

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

Требования

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