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