共用方式為

ACTRL_ACCESS_ENTRYA結構 （accctrl.h）

  • 發行項

包含指定信任項的訪問控制資訊。 此結構會儲存與儲存在 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

信任 結構，可識別存取控制專案套用至其中的使用者、群組或程式（例如服務）。

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
 主要物件所包含的非container 物件會繼承專案。
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
 主要物件所包含的非container 物件會繼承專案。 此旗標會對應至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

受託人