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

Статья
08/25/2023

Функция CreateWellKnownSid создает идентификатор безопасности для предопределенных псевдонимов.

Синтаксис

BOOL CreateWellKnownSid(
  [in]            WELL_KNOWN_SID_TYPE WellKnownSidType,
  [in, optional]  PSID                DomainSid,
  [out, optional] PSID                pSid,
  [in, out]       DWORD               *cbSid
);

Параметры

[in] WellKnownSidType

Член перечисления WELL_KNOWN_SID_TYPE , указывающий, что идентификатор безопасности будет определять.

[in, optional] DomainSid

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

[out, optional] pSid

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

[in, out] cbSid

Указатель на DWORD , содержащий количество байтов, доступных в pSid. Функция CreateWellKnownSid хранит количество байтов, фактически используемых в этом расположении.

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

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

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

Требования


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

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

EqualDomainSid

GetWindowsAccountDomainSid

IsWellKnownSid

WELL_KNOWN_SID_TYPE

Поделиться через