getSidIdentifierAuthority 函数 (securitybaseapi.h)

GetSidIdentifierAuthority 函数返回指向指定安全标识符中SID_IDENTIFIER_AUTHORITY结构的指针 (SID) 。

语法

PSID_IDENTIFIER_AUTHORITY GetSidIdentifierAuthority(
  [in] PSID pSid
);

参数

[in] pSid

指向 SID 结构的指针,为其返回指向 SID_IDENTIFIER_AUTHORITY 结构的指针。

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

返回值

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

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

注解

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

要求

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

另请参阅

访问控制概述

基本访问控制函数

CreateWellKnownSid

GetLengthSid

GetSidLengthRequired

GetSidSubAuthority

GetSidSubAuthorityCount

IsValidSid

SID

SID_IDENTIFIER_AUTHORITY