GetSidLengthRequired 函式 (securitybaseapi.h)

GetSidLengthRequired函式會傳回儲存具有指定子授權數目之 SID 所需的緩衝區長度,以位元組為單位。

語法

DWORD GetSidLengthRequired(
  [in] UCHAR nSubAuthorityCount
);

參數

[in] nSubAuthorityCount

指定要儲存在 SID 結構中的子授權數目。

傳回值

傳回值是儲存 SID 結構所需的緩衝區長度,以位元組為單位。 此函式無法失敗。

備註

nSubAuthorityCount中指定的SID結構會使用 32 位 RID 值。 對於需要較長 RID 值的應用程式,請使用 CreateWellKnownSid 和相關函式。

需求

   
最低支援的用戶端 Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 securitybaseapi.h (包括 Windows.h)
程式庫 Advapi32.lib
Dll Advapi32.dll

另請參閱

存取控制概觀

AllocateAndInitializeSid

基本存取控制函式

CreateWellKnownSid

GetLengthSid

GetSidIdentifierAuthority

GetSidSubAuthority

GetSidSubAuthorityCount

InitializeSid

IsValidSid

SID