TRUSTEE_A 結構 (accctrl.h)

發行項
02/26/2024

TRUSTEE 結構會識別套用訪問控制專案 (ACE) 的用戶帳戶、組帳戶或登入會話。結構可以使用名稱或安全性標識碼 (SID) 來識別信任項。

訪問控制功能，例如 SetEntriesInAcl 和 GetExplicitEntriesFromAcl，使用此結構來識別與EXPLICIT_ACCESS 結構中訪問控制或稽核控制資訊相關聯的登入帳戶。

語法

typedef struct _TRUSTEE_A {
  struct _TRUSTEE_A          *pMultipleTrustee;
  MULTIPLE_TRUSTEE_OPERATION MultipleTrusteeOperation;
  TRUSTEE_FORM               TrusteeForm;
  TRUSTEE_TYPE               TrusteeType;
  union {
    LPSTR              ptstrName;
    SID                *pSid;
    OBJECTS_AND_SID    *pObjectsAndSid;
    OBJECTS_AND_NAME_A *pObjectsAndName;
  };
  LPCH                       ptstrName;
} TRUSTEE_A, *PTRUSTEE_A, TRUSTEEA, *PTRUSTEEA;

成員

pMultipleTrustee

信任項結構的指標，識別可以模擬 ptstrName 成員所識別之使用者的伺服器帳戶。目前不支援此成員，而且必須是 NULL。

MultipleTrusteeOperation

MULTIPLE_TRUSTEE_OPERATION列舉型別的值。目前，這個成員必須NO_MULTIPLE_TRUSTEE。

TrusteeForm

來自 TRUSTEE_FORM 列舉型別的值，指出 ptstrName 成員所指向的數據類型。

TrusteeType

來自 TRUSTEE_TYPE 列舉型別的值，指出信任項是用戶帳戶、組帳戶還是未知的帳戶類型。

ptstrName

識別信任項的緩衝區指標，並選擇性地包含物件特定 ACE 的相關信息。數據類型取決於 TrusteeForm 成員的值。

這個成員可以是下列其中一個值。

值	意義
TRUSTEE_IS_NAME	包含信任項名稱之 Null 終止字串的指標。
TRUSTEE_IS_OBJECTS_AND_NAME	OBJECTS_AND_NAME 結構的指標，其中包含信任項的名稱，以及物件特定 ACE 中物件類型的名稱。
TRUSTEE_IS_OBJECTS_AND_SID	OBJECTS_AND_SID 結構的指標，其中包含信任項的 SID，以及物件特定 ACE 中物件類型的 GUID。
TRUSTEE_IS_SID	信任項 SID 的指標。

pSid

pObjectsAndSid

pObjectsAndName

備註

信任項目名稱可以有下列任何格式：

完整名稱，例如「g：\remotedir\abc」。。
網域帳戶，例如「domain1\xyz」。。
其中一個預先定義的組名，例如「EVERYONE」或「GUEST」。。

下列其中一個特殊名稱。

名稱	意義
CREATOR GROUP	CREATOR_GROUP SID 是用於可繼承 ACE 的 SID。建立新物件時，系統會將此 SID 取代為建立物件之使用者的主要群組 SID。
CREATOR OWNER	CREATOR_OWNER SID 是用於可繼承 ACE 的 SID。建立新物件時，系統會將此 SID 取代為建立物件之使用者的 SID。
CURRENT_USER	呼叫線程或進程的擁有者。

信任項 SID 可以是任何使用者或群組 SID。它也可以是任何通用、已知的 SID。如需詳細資訊，請參閱安全性標識符。

注意

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

規格需求

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