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

指向 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 调用线程或进程的所有者。
     
受信人 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