CreateWellKnownSid 函数 (securitybaseapi.h)

CreateWellKnownSid 函数为预定义别名创建 SID。

语法

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

parameters

[in] WellKnownSidType

WELL_KNOWN_SID_TYPE枚举的成员,该枚举指定 SID 将标识的内容。

[in, optional] DomainSid

指向 SID 的指针,该指针标识创建 SID 时要使用的域。 传递 NULL 以使用本地计算机。

[out, optional] pSid

指向内存的指针, CreateWellKnownSid 将存储新 SID。

[in, out] cbSid

指向包含 pSid 处可用字节数的 DWORD 的指针。 CreateWellKnownSid 函数存储在此位置实际使用的字节数。

返回值

如果该函数成功,则返回值为非零值。

如果函数失败,则返回值为零。 有关扩展的错误信息,请调用 GetLastError

要求

   
最低受支持的客户端 Windows XP [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2003 [桌面应用 | UWP 应用]
目标平台 Windows
标头 securitybaseapi.h (包括 Windows.h)
Library Advapi32.lib
DLL Advapi32.dll

请参阅

EqualDomainSid

GetWindowsAccountDomainSid

IsWellKnownSid

WELL_KNOWN_SID_TYPE