ACTRL_ACCESS_ENTRYA 結構 (accctrl.h)

發行項
03/05/2024

包含指定信任項的訪問控制資訊。此結構會儲存相當於儲存在 ACE 中的存取控制資訊的資訊。

語法

typedef struct _ACTRL_ACCESS_ENTRYA {
  TRUSTEE_A     Trustee;
  ULONG         fAccessFlags;
  ACCESS_RIGHTS Access;
  ACCESS_RIGHTS ProvSpecificAccess;
  INHERIT_FLAGS Inheritance;
  LPSTR         lpInheritProperty;
} ACTRL_ACCESS_ENTRYA, *PACTRL_ACCESS_ENTRYA;

成員

Trustee

可識別使用者、群組或程式 (的 TRUSTEE 結構，例如套用存取控制專案的服務) 。

fAccessFlags

指出 Access 和 ProvSpecificAccess 成員所指定的訪問許可權如何套用至信任項。這個成員可以是下列其中一個值。如果您使用這個結構搭配 IAccessControl 的 COM 實作，則必須ACTRL_ACCESS_ALLOWED或ACTRL_ACCESS_DENIED這個成員。

值	意義
ACTRL_ACCESS_ALLOWED 0x00000001	允許許可權。
ACTRL_ACCESS_DENIED 0x00000002	許可權遭到拒絕。
ACTRL_AUDIT_SUCCESS 0x00000004	系統會針對嘗試使用許可權失敗的嘗試產生稽核訊息。
ACTRL_AUDIT_FAILURE 0x00000008	系統會產生稽核訊息，以成功嘗試使用許可權。

Access

位掩碼，指定專案允許、拒絕或稽核信任者的訪問許可權。

這個成員必須使用提供者無關的存取旗標，例如ACTRL_READ_CONTROL，而不是存取旗標，例如READ_CONTROL。物件類型的提供者會將這些提供者無關的旗標轉換為對應的提供者特定旗標。

如果您使用這個結構搭配 IAccessControl 的 COM 實作，則必須COM_RIGHTS_EXECUTE這個成員。

ACTRL_SYSTEM_ACCESS

ACTRL_DELETE

ACTRL_READ_CONTROL

ACTRL_CHANGE_ACCESS

ACTRL_CHANGE_OWNER

ACTRL_SYNCHRONIZE

ACTRL_STD_RIGHTS_ALL

ACTRL_STD_RIGHT_REQUIRED

COM_RIGHTS_EXECUTE

COM_RIGHTS_EXECUTE_LOCAL

COM_RIGHTS_EXECUTE_REMOTE

COM_RIGHTS_ACTIVATE_LOCAL

COM_RIGHTS_ACTIVATE_REMOTE

ProvSpecificAccess

指定提供者類型特定訪問許可權的位掩碼。使用 ACTRL_ACCESS_ENTRY 結構的函式會將這些位傳遞至提供者，而不需要解譯它們。在大部分情況下，此成員應該是0。

Inheritance

一組位旗標，決定其他容器或物件是否可以從附加存取清單的主要物件繼承訪問控制專案。如果您使用這個結構搭配 IAccessControl 的 COM 實作，這個值必須NO_INHERITANCE，這表示訪問控制專案無法繼承。否則，這個值可以是NO_INHERITANCE，也可以是下列值的組合。

值	意義
CONTAINER_INHERIT_ACE 0x2	主要物件所包含的其他容器會繼承該項目。
INHERIT_ONLY_ACE 0x8	ACE 不適用於附加 ACL 的主要物件，但主要物件所包含的物件會繼承專案。
NO_PROPAGATE_INHERIT_ACE 0x4	OBJECT_INHERIT_ACE和CONTAINER_INHERIT_ACE旗標不會傳播至繼承的專案。
OBJECT_INHERIT_ACE 0x1	主要物件所包含的非容器物件會繼承專案。
SUB_CONTAINERS_AND_OBJECTS_INHERIT 0x3	主物件所包含的容器和非容器物件都會繼承專案。此旗標會對應至CONTAINER_INHERIT_ACE和OBJECT_INHERIT_ACE旗標的組合。
SUB_CONTAINERS_ONLY_INHERIT 0x2	主要物件所包含的其他容器會繼承該項目。此旗標會對應至CONTAINER_INHERIT_ACE旗標。
SUB_OBJECTS_ONLY_INHERIT 0x1	主要物件所包含的非容器物件會繼承專案。此旗標會對應至OBJECT_INHERIT_ACE旗標。

lpInheritProperty

以 Null 結束之字串的指標，可識別可繼承專案的物件類型。如果您使用這個結構搭配 IAccessControl 的 COM 實作，這個成員必須是 NULL。

備註

注意

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

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
標頭	accctrl.h

另請參閱

ACTRL_ACCESS_ENTRY_LIST

受託人

共用方式為