TRUSTEE_W 结构 (accctrl.h)

TRUSTEE 结构标识访问控制 (ACE) 应用到的用户帐户、组帐户或登录会话。 结构可以使用名称或 安全标识符 (SID) 来标识受信人。

访问控制函数(如 SetEntriesInAclGetExplicitEntriesFromAcl)使用此结构来标识与 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 调用线程或进程的所有者。
     
受信人 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