OBJECTS_AND_NAME_A 結構 (accctrl.h)

發行項
02/23/2024

OBJECTS_AND_NAME 結構包含字串，該字串會依名稱識別信任項，以及識別特定物件訪問控制專案之物件類型的字串， (ACE) 。

語法

typedef struct _OBJECTS_AND_NAME_A {
  DWORD          ObjectsPresent;
  SE_OBJECT_TYPE ObjectType;
  LPSTR          ObjectTypeName;
  LPSTR          InheritedObjectTypeName;
  LPSTR          ptstrName;
} OBJECTS_AND_NAME_A, *POBJECTS_AND_NAME_A;

成員

ObjectsPresent

指出 ObjectTypeName 和 InheritedObjectTypeName 成員是否包含字串。此參數可以是下列值的組合。

值	意義
ACE_OBJECT_TYPE_PRESENT 0x1	ObjectTypeName 成員包含字串。
ACE_INHERITED_OBJECT_TYPE_PRESENT 0x2	InheritedObjectTypeName 成員包含字串。

ObjectType

指定 SE_OBJECT_TYPE列舉的值，這個值表示對象的類型。

ObjectTypeName

Null 終止字串的指標，可識別 ACE 套用的物件類型。

此字串必須是Active Directory 架構中的有效 LDAP 顯示名稱。

InheritedObjectTypeName

Null 終止字串的指標，可識別可繼承 ACE 的物件類型。

此字串必須是Active Directory 架構中的有效 LDAP 顯示名稱。

如果未在 ObjectsPresent 成員中設定ACE_INHERITED_OBJECT_TYPE_PRESENT位， 則會忽略 InheritedObjectTypeName 成員，而且所有類型的子物件都可以繼承 ACE。否則，只有指定的物件類型可以繼承 ACE。不論是哪一種情況，繼承也會受到 ACE_HEADER 結構中的繼承旗標以及任何保護，而不受子物件上所放置之繼承的保護所控制。

ptstrName

包含信任項名稱之 Null 終止字串的指標。

備註

TRUSTEE 結構的 ptstrName 成員可以是OBJECTS_AND_NAME結構的指標。這可讓 SetEntriesInAcl 和 GetExplicitEntriesFromAcl 等函式，將物件特定的 ACE 資訊儲存在EXPLICIT_ACCESS結構的信任者成員中。

注意

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

規格需求

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