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

Статья
08/25/2023

Функция InitializeSid инициализирует идентификатор безопасности (SID).

Синтаксис

BOOL InitializeSid(
  [out] PSID                      Sid,
  [in]  PSID_IDENTIFIER_AUTHORITY pIdentifierAuthority,
  [in]  BYTE                      nSubAuthorityCount
);

Параметры

[out] Sid

Указатель на инициализируемый идентификатор безопасности .

[in] pIdentifierAuthority

Указатель на структуру SID_IDENTIFIER_AUTHORITY , задается в структуре SID .

[in] nSubAuthorityCount

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

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

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

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

Хотя функция InitializeSid задает количество вложенных учетных данных для идентификатора безопасности, она не задает значения вложенного удостоверений. Это необходимо сделать отдельно с помощью таких функций, как GetSidSubAuthority.

Приложение может использовать функцию AllocateAndInitializeSid для инициализации идентификатора безопасности и задания его значений вложенности.

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

Требования

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