BuildTrusteeWithNameW 函数 (aclapi.h)

项目
02/23/2024

BuildTrusteeWithName 函数初始化TRUST 结构。调用方指定受信人名称。函数将结构的其他成员设置为默认值。

语法

void BuildTrusteeWithNameW(
  [in, out]      PTRUSTEE_W pTrustee,
  [in, optional] LPWSTR     pName
);

参数

[in, out] pTrustee

指向要初始化的 TRUSTEE 结构的指针。 BuildTrusteeWithName 函数不分配任何内存。如果此参数为 NULL 或指针无效，则结果为未定义。

[in, optional] pName

指向以 null 结尾的字符串的指针，该字符串包含 TRUSTEE 结构的 ptstrName 成员的受信者的名称。 BuildTrusteeWithName 函数按如下所示设置TRUST 结构的其他成员。

值	含义
pMultipleTrustee	Null
MultipleTrusteeOperation	NO_MULTIPLE_TRUSTEE
受信人窗体	TRUSTEE_IS_NAME
受信人类型	TRUSTEE_IS_UNKNOWN

返回值

无

备注

注意

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

要求

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