TRUSTEE_W 結構 (accctrl.h)
TRUSTEE 結構會識別訪問控制專案套用 (ACE) 的用戶帳戶、群組帳戶或登入會話。 結構可以使用名稱或 安全性標識碼 (SID) 來識別信任者。
訪問控制函式,例如 SetEntriesInAcl 和 GetExplicitEntriesFromAcl,使用此結構來識別 與EXPLICIT_ACCESS 結構中訪問控制或稽核控制資訊相關聯的登入帳戶。
語法
typedef struct _TRUSTEE_W {
struct _TRUSTEE_W *pMultipleTrustee;
MULTIPLE_TRUSTEE_OPERATION MultipleTrusteeOperation;
TRUSTEE_FORM TrusteeForm;
TRUSTEE_TYPE TrusteeType;
union {
LPWSTR ptstrName;
SID *pSid;
OBJECTS_AND_SID *pObjectsAndSid;
OBJECTS_AND_NAME_W *pObjectsAndName;
};
LPWCH ptstrName;
} TRUSTEE_W, *PTRUSTEE_W, TRUSTEEW, *PTRUSTEEW;
成員
pMultipleTrustee
可識別可模擬 ptstrName 成員所識別之使用者之伺服器帳戶的 TRUSTEE 結構的指標。 目前不支援此成員,而且必須是 NULL。
MultipleTrusteeOperation
MULTIPLE_TRUSTEE_OPERATION列舉類型的值。 目前,此成員必須NO_MULTIPLE_TRUSTEE。
TrusteeForm
來自TRUSTEE_FORM列舉型別的值,指出 ptstrName 成員所指向的數據類型。
TrusteeType
來自TRUSTEE_TYPE列舉型別的值,指出信任者是用戶帳戶、群組帳戶或未知的帳戶類型。
ptstrName
緩衝區的指標,可識別信任項,並選擇性地包含物件特定 ACE 的相關信息。 數據類型取決於 TrusteeForm 成員的值。
這個成員可以是下列其中一個值。
值 | 意義 |
---|---|
|
包含信任項名稱之 Null 終止字串的指標。 |
|
OBJECTS_AND_NAME 結構的指標 ,其中包含信任項的名稱,以及物件特定 ACE 中物件類型的名稱。 |
|
OBJECTS_AND_SID 結構的指標 ,其中包含信任項的 SID,以及物件特定 ACE 中物件類型的 GUID。 |
|
信任者的 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 呼叫線程或進程的擁有者。
注意
accctrl.h 標頭會將TRUSTEE_定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
標頭 | accctrl.h |