TRUSTEE_W 结构 (accctrl.h)

项目
02/23/2024

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

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