共用方式為


TRUSTEE_A 結構 (accctrl.h)

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

訪問控制功能,例如 SetEntriesInAclGetExplicitEntriesFromAcl,使用此結構來識別 與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

另請參閱

ACL

EXPLICIT_ACCESS

GetExplicitEntriesFromAcl

MULTIPLE_TRUSTEE_OPERATION

OBJECTS_AND_NAME

OBJECTS_AND_SID

SID

SetEntriesInAcl

TRUSTEE_FORM

TRUSTEE_TYPE