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