getSidSubAuthority 函数 (securitybaseapi.h)
GetSidSubAuthority 函数返回指向安全标识符中指定子授权的指针, (SID) 。 subauthority 值是 RID) (相对标识符 。
语法
PDWORD GetSidSubAuthority(
[in] PSID pSid,
[in] DWORD nSubAuthority
);
参数
[in] pSid
指向 SID 结构的指针,从中返回指向子授权的指针。
此函数不处理无效的 SID 结构。 调用 IsValidSid 函数以在调用此函数之前验证 SID 结构是否有效。
[in] nSubAuthority
指定一个索引值,该值标识函数将返回其地址的子授权数组元素。 函数不对此值执行验证测试。 应用程序可以调用 GetSidSubAuthorityCount 函数来发现可接受的值范围。
返回值
如果函数成功,则返回值是指向指定 SID 子授权的指针。 要获得更多的错误信息,请调用 GetLastError。
如果函数失败,则返回值未定义。 如果指定的 SID 结构无效,或者 nSubAuthority 参数指定的索引值超出边界,则函数将失败。
注解
pSid 中指定的 SID 结构使用 32 位 RID 值。 对于需要较长 RID 值的应用程序,请使用 CreateWellKnownSid 和相关函数。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [桌面应用 | UWP 应用] |
最低受支持的服务器 | Windows Server 2003 [桌面应用 | UWP 应用] |
目标平台 | Windows |
标头 | securitybaseapi.h (包括 Windows.h) |
Library | Advapi32.lib |
DLL | Advapi32.dll |