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

См. также раздел

Управление доступом

Базовые функции контроль доступа

FreeSid

GetSidIdentifierAuthority

InitializeSid

SID_IDENTIFIER_AUTHORITY

Известные идентификаторы безопасности