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

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

Требования

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

EqualDomainSid

GetWindowsAccountDomainSid

IsWellKnownSid

WELL_KNOWN_SID_TYPE