Функция AllocateAndInitializeSid (securitybaseapi.h)
Функция AllocateAndInitializeSid выделяет и инициализирует идентификатор безопасности (SID) с восемью вложенными учетными данными.
Синтаксис
BOOL AllocateAndInitializeSid(
[in] PSID_IDENTIFIER_AUTHORITY pIdentifierAuthority,
[in] BYTE nSubAuthorityCount,
[in] DWORD nSubAuthority0,
[in] DWORD nSubAuthority1,
[in] DWORD nSubAuthority2,
[in] DWORD nSubAuthority3,
[in] DWORD nSubAuthority4,
[in] DWORD nSubAuthority5,
[in] DWORD nSubAuthority6,
[in] DWORD nSubAuthority7,
[out] PSID *pSid
);
Параметры
[in] pIdentifierAuthority
Указатель на структуру SID_IDENTIFIER_AUTHORITY . Эта структура предоставляет значение центра идентификатора верхнего уровня для задания в идентификаторе безопасности.
[in] nSubAuthorityCount
Указывает количество вложенных учетных данных, размещаемых в идентификаторе безопасности. Этот параметр также определяет, сколько параметров подчиненной проверки подлинности имеют значимые значения. Этот параметр должен содержать значение от 1 до 8.
Например, значение 3 указывает на то, что значения subauthority, заданные параметрами dwSubAuthority0, dwSubAuthority1 и dwSubAuthority2 , имеют значимые значения и пропускают остаток.
[in] nSubAuthority0
Значение subauthority для размещения в идентификаторе безопасности.
[in] nSubAuthority1
Значение subauthority для размещения в идентификаторе безопасности.
[in] nSubAuthority2
Значение subauthority для размещения в идентификаторе безопасности.
[in] nSubAuthority3
Значение subauthority для размещения в идентификаторе безопасности.
[in] nSubAuthority4
Значение subauthority для размещения в идентификаторе безопасности.
[in] nSubAuthority5
Значение subauthority для размещения в идентификаторе безопасности.
[in] nSubAuthority6
Значение subauthority для размещения в идентификаторе безопасности.
[in] nSubAuthority7
Значение subauthority для размещения в идентификаторе безопасности.
[out] pSid
Указатель на переменную, которая получает указатель на выделенную и инициализированную структуру SID .
Возвращаемое значение
Если функция выполняется успешно, возвращается ненулевое значение.
Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
Идентификатор безопасности, выделенный с помощью функции AllocateAndInitializeSid , должен быть освобожден с помощью функции FreeSid .
Эта функция создает идентификатор безопасности с 32-разрядным значением RID. Для приложений, которым требуются более длинные значения RID, используйте CreateWellKnownSid.
Примеры
Пример использования этой функции см. в разделе Создание дескриптора безопасности для нового объекта или Получение владения объектом.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2003 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | securitybaseapi.h (включая Windows.h) |
| Библиотека | Advapi32.lib |
| DLL | Advapi32.dll |