GetSidSubAuthorityCount 函数 (securitybaseapi.h)

GetSidSubAuthorityCount 函数返回指向包含子授权计数的安全标识符 (SID) 结构中的成员的指针。

语法

PUCHAR GetSidSubAuthorityCount(
  [in] PSID pSid
);

参数

[in] pSid

指向 SID 结构的指针,从中返回指向子授权计数的指针。

此函数不处理无效的 SID 结构。 调用 IsValidSid 函数以在调用此函数之前验证 SID 结构是否有效。

返回值

如果函数成功,则返回值是指向指定 SID 结构的子授权计数的指针。

如果函数失败,则返回值未定义。 如果指定的 SID 结构无效,函数将失败。 要获得更多的错误信息,请调用 GetLastError。

注解

pSid 中指定的 SID 结构使用 32 位值。 对于需要较长 RID 值的应用程序,请使用 CreateWellKnownSid 和相关函数。

要求

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

另请参阅

访问控制概述

基本访问控制函数

CreateWellKnownSid

GetLengthSid

GetSidIdentifierAuthority

GetSidLengthRequired

GetSidSubAuthority

IsValidSid

SID