InitializeSid 函数 (securitybaseapi.h)

项目
03/01/2024

InitializeSid 函数 (SID) 初始化安全标识符。

语法

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

参数

[out] Sid

指向要初始化的 SID 结构的指针。

[in] pIdentifierAuthority

指向在 SID 结构中设置的SID_IDENTIFIER_AUTHORITY结构的指针。

[in] nSubAuthorityCount

指定要在 SID 中设置的子授权数。子授权的值必须单独设置，如以下备注部分所述。

返回值

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

如果函数失败，则返回值为零。要获得更多的错误信息，请调用 GetLastError。

注解

尽管 InitializeSid 函数设置 SID 的子授权数，但它不设置子授权值。必须使用 GetSidSubAuthority 等函数单独执行此操作。

应用程序可以使用 AllocateAndInitializeSid 函数初始化 SID 并设置其子授权值。

此函数使用 32 位 RID 值。对于需要较大 RID 值的应用程序，请使用 CreateWellKnownSid。

要求

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