TRUSTEE_A 结构 (accctrl.h)

项目
02/23/2024

TRUSTEE 结构标识访问控制项 (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	调用线程或进程的所有者。