GetSidLengthRequired 函数 (securitybaseapi.h)

GetSidLengthRequired 函数返回存储具有指定数量的子授权的 SID 所需的缓冲区长度(以字节为单位)。

语法

DWORD GetSidLengthRequired(
  [in] UCHAR nSubAuthorityCount
);

parameters

[in] nSubAuthorityCount

指定要存储在 SID 结构中的子授权数。

返回值

返回值是存储 SID 结构所需的缓冲区的长度(以字节为单位)。 此函数不能失败。

注解

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

要求

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

请参阅

访问控制概述

AllocateAndInitializeSid

基本访问控制函数

CreateWellKnownSid

GetLengthSid

GetSidIdentifierAuthority

GetSidSubAuthority

GetSidSubAuthorityCount

InitializeSid

IsValidSid

SID