BuildTrusteeWithObjectsAndNameA 函数 (aclapi.h)

项目
08/22/2023

BuildTrusteeWithObjectsAndName 函数使用特定于对象的访问控制项 (ACE) 信息初始化 TRUSTEE 结构，并将结构的其余成员初始化为默认值。调用方还指定受托人的名称。

语法

void BuildTrusteeWithObjectsAndNameA(
  [in, out]      PTRUSTEE_A          pTrustee,
  [in, optional] POBJECTS_AND_NAME_A pObjName,
  [in, optional] SE_OBJECT_TYPE      ObjectType,
  [in, optional] LPSTR               ObjectTypeName,
  [in, optional] LPSTR               InheritedObjectTypeName,
  [in, optional] LPSTR               Name
);

参数

[in, out] pTrustee

指向将由此函数初始化的 TRUSTEE 结构的指针。如果此参数的值为 NULL 或指针无效，则结果为未定义。

[in, optional] pObjName

指向 OBJECTS_AND_NAME 结构的指针，该结构包含有关受托人和安全对象的信息。

[in, optional] ObjectType

指向包含安全对象类型相关信息的SE_OBJECT_TYPE 枚举的指针。

[in, optional] ObjectTypeName

指向字符串的指针，该字符串指定要添加到 pTrustee 参数中返回的TRUST 结构的 ObjectType GUID 对应的名称。此函数确定与此名称对应的 ObjectType GUID。

[in, optional] InheritedObjectTypeName

指向字符串的指针，该字符串指定要添加到 pTrustee 参数中返回的TRUST 结构的 InheritedObjectType GUID 对应的名称。此函数确定与此名称对应的 InheritedObjectType GUID。

[in, optional] Name

指向字符串的指针，该字符串指定用于标识受托人的名称。

返回值

无

备注

此函数不为 TRUSTEE 和 OBJECTS_AND_NAME 结构分配内存。

有关特定于对象的 ACE 的详细信息，请参阅特定于对象的 ACE。

注意

aclapi.h 标头将 BuildTrusteeWithObjectsAndName 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	aclapi.h
Library	Advapi32.lib
DLL	Advapi32.dll