BuildTrusteeWithObjectsAndSidA 函数 (aclapi.h)

BuildTrusteeWithObjectsAndSid 函数使用特定于对象的访问控制项初始化一个TRUST 结构, (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

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

[in, optional] pObjSid

指向 OBJECTS_AND_SID 结构的指针,该结构包含有关受信者和安全对象的信息。

[in, optional] pObjectGuid

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

[in, optional] pInheritedObjectGuid

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

[in, optional] pSid

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

返回值

备注

此函数不会为 TRUSTEEOBJECTS_AND_SID 结构分配内存。

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

注意

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

要求

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

另请参阅

访问控制

基本访问控制函数

BuildTrusteeWithName

BuildTrusteeWithObjectsAndName

BuildTrusteeWithSid

OBJECTS_AND_NAME

特定于对象的 ACE

SE_OBJECT_TYPE

SID

受托 人