BuildTrusteeWithObjectsAndSidA 函数（aclapi.h）

项目
11/20/2024

BuildTrusteeWithObjectsAndSid 函数使用特定于对象的访问控制项（ACE）信息初始化受托人结构，并将结构的其余成员初始化为默认值。调用方还指定 SID 结构，该结构表示受托方的安全标识符。

语法

void BuildTrusteeWithObjectsAndSidA(
  [in, out]      PTRUSTEE_A       pTrustee,
  [in, optional] POBJECTS_AND_SID pObjSid,
  [in, optional] GUID             *pObjectGuid,
  [in, optional] GUID             *pInheritedObjectGuid,
  [in, optional] PSID             pSid
);

参数

[in, out] pTrustee

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

[in, optional] pObjSid

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

[in, optional] pObjectGuid

指向 GUID 结构的指针，该结构描述要添加到受托人结构的 ObjectType GUID。

[in, optional] pInheritedObjectGuid

指向 GUID 结构的指针，该结构描述要添加到 TRUSTEE 结构的 InheritedObjectType GUID。

[in, optional] pSid

指向标识受托人的 SID 结构的指针。

返回值

没有

言论

此函数不会为受托人和 OBJECTS_AND_SID 结构分配内存。

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

注意

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

要求

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