TRUSTEE_A結構（accctrl.h）

發行項
11/20/2024

受託人 結構會識別套用訪問控制專案（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

TRUSTEE 結構的指標，識別可以模擬 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