BuildExplicitAccessWithNameA 函式（aclapi.h）

發行項
11/20/2024

BuildExplicitAccessWithName 函式會使用呼叫端指定的數據，初始化 EXPLICIT_ACCESS 結構。信任項會以名稱字串來識別。

語法

void BuildExplicitAccessWithNameA(
  [in, out]      PEXPLICIT_ACCESS_A pExplicitAccess,
  [in, optional] LPSTR              pTrusteeName,
  [in]           DWORD              AccessPermissions,
  [in]           ACCESS_MODE        AccessMode,
  [in]           DWORD              Inheritance
);

參數

[in, out] pExplicitAccess

要初始化之 EXPLICIT_ACCESS 結構的指標。 BuildExplicitAccessWithName 函式不會配置任何記憶體。這個參數不能 NULL。

[in, optional] pTrusteeName

null-terminated 字串的指標，其中包含 TRUSTEE 結構之 ptstrName 成員之信任項的名稱。 BuildExplicitAccessWithName 函式會設定 TRUSTEE 結構的其他成員，如下所示。

價值	意義
pMultipleTrustee	NULL
MultipleTrusteeOperation	NO_MULTIPLE_TRUSTEE
TrusteeForm	TRUSTEE_IS_NAME
TrusteeType	TRUSTEE_IS_UNKNOWN

[in] AccessPermissions

指定 grfAccessPermissionsEXPLICIT_ACCESS 結構成員的存取遮罩。遮罩是一組位旗標，使用 ACCESS_MASK 格式來指定 ACE 允許、拒絕或稽核信任者的訪問許可權。使用 EXPLICIT_ACCESS 結構的函式不會轉換、解譯或驗證此遮罩中的位。

[in] AccessMode

指定 grfAccessModeEXPLICIT_ACCESS 結構成員的存取模式。存取模式指出訪問控制專案允許、拒絕或稽核指定的許可權。對於選擇性訪問控制清單（DACL），這個參數可以是 ACCESS_MODE 列舉中的其中一個值。針對系統訪問控制清單（SACL），此參數可以是 ACCESS_MODE 值的組合。

[in] Inheritance

指定 grfInheritance 結構成員 EXPLICIT_ACCESS 的繼承類型。這個值是一組位旗標，可判斷其他容器或物件是否可以從附加 ACL 的主要物件繼承 ACE。這個成員的值對應於 AceFlags 成員 ACE_HEADER 結構的繼承部分（低序位元組）。這個參數可以是NO_INHERITANCE，表示 ACE 不可繼承，也可以是下列值的組合。

價值	意義
CONTAINER_INHERIT_ACE	主要物件所包含的其他容器會繼承 ACE。
INHERIT_ONLY_ACE	ACE 不適用於附加 ACL 的主要物件，但主要物件所包含的物件會繼承 ACE。
NO_PROPAGATE_INHERIT_ACE	OBJECT_INHERIT_ACE和CONTAINER_INHERIT_ACE旗標不會傳播至繼承的 ACE。
OBJECT_INHERIT_ACE	主要物件所包含的非container 物件會繼承 ACE。
SUB_CONTAINERS_AND_OBJECTS_INHERIT	主要物件所包含的容器和非容器對象都會繼承 ACE。此旗標對應於CONTAINER_INHERIT_ACE和OBJECT_INHERIT_ACE旗標的組合。
SUB_CONTAINERS_ONLY_INHERIT	主要物件所包含的其他容器會繼承 ACE。此旗標對應於 CONTAINER_INHERIT_ACE 和 INHERIT_ONLY_ACE 旗標的組合。
SUB_OBJECTS_ONLY_INHERIT	主要物件所包含的非container 物件會繼承 ACE。此旗標對應於 OBJECT_INHERIT_ACE 和 INHERIT_ONLY_ACE 旗標的組合。

傳回值

沒有

言論

注意

aclapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 BuildExplicitAccessWithName 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求

要求	價值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
支援的最低伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平臺	窗戶
標頭	aclapi.h
連結庫	Advapi32.lib
DLL	Advapi32.dll