InitializeSid 函数 (securitybaseapi.h)
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 |