TRUSTEE_W结构（accctrl.h）

项目
11/20/2024

受托人结构标识访问控制项（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

指向 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 所有者	CREATOR_OWNER SID 是在可继承的 ACE 中使用的 SID。创建新对象时，系统将此 SID 替换为创建该对象的用户的 SID。
CURRENT_USER	调用线程或进程的所有者。