共用方式為


securitybaseapi.h (GetAclInformation 函式)

GetAclInformation 函式會擷取訪問控制清單的相關信息, (ACL) 。

語法

BOOL GetAclInformation(
  [in]  PACL                  pAcl,
  [out] LPVOID                pAclInformation,
  [in]  DWORD                 nAclInformationLength,
  [in]  ACL_INFORMATION_CLASS dwAclInformationClass
);

參數

[in] pAcl

ACL 的指標。 函式會擷取此 ACL 的相關信息。 如果傳遞 Null 值,函式會造成存取違規。

[out] pAclInformation

要接收所要求信息的緩衝區指標。 放入緩衝區的結構取決於 dwAclInformationClass 參數中所要求的信息類別。

[in] nAclInformationLength

pAclInformation 參數所指向緩衝區的大小,以位元組為單位。

[in] dwAclInformationClass

指出所要求資訊類別 的 ACL_INFORMATION_CLASS 列舉值。 這個參數可以是這個列舉中兩個值的其中一個:

  • 如果值為 AclRevisionInformation,函式會以ACL_REVISION_INFORMATION結構填入 pAclInformation 參數指向的緩衝區。
  • 如果值為 AclSizeInformation,函式會以ACL_SIZE_INFORMATION結構填入 pAclInformation 參數指向的緩衝區。

傳回值

如果函式成功,函式會傳回非零。

如果函式失敗,則會傳回零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

規格需求

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

另請參閱

ACL_INFORMATION_CLASS

ACL_REVISION_INFORMATION

ACL_SIZE_INFORMATION

GetAce

InitializeAcl

IsValidAcl

低階 存取控制

低階 存取控制 函式

SetAclInformation