DSCreateISecurityInfoObject 函数 (dssec.h)

DSCreateISecurityInfoObject 函数创建与指定目录服务关联的 ISecurityInformation 接口的实例 (DS) 对象。

语法

HRESULT DSCreateISecurityInfoObject(
  [in]           LPCWSTR                pwszObjectPath,
  [in]           LPCWSTR                pwszObjectClass,
  [in]           DWORD                  dwFlags,
  [out]          LPSECURITYINFO         *ppSI,
  [in, optional] PFNREADOBJECTSECURITY  pfnReadSD,
  [in, optional] PFNWRITEOBJECTSECURITY pfnWriteSD,
  [in]           LPARAM                 lpContext
);

参数

[in] pwszObjectPath

要为其创建 ISecurityInformation 接口实例的 DS 对象的完整路径。

[in] pwszObjectClass

由 pwszObjectPath 参数指定的 对象的类。

[in] dwFlags

用于与 ISecurityInformation 接口的新实例关联的安全属性页的标志。 此参数可以是以下标志的任意组合。

含义
DSSI_READ_ONLY
0x00000001
安全属性是只读的。
DSSI_NO_ACCESS_CHECK
0x00000002
不执行访问检查。
DSSI_NO_EDIT_SACL
0x00000004
SACL) 属性 (系统访问控制列表 是只读的。
DSSI_NO_EDIT_OWNER
0x00000008
对象所有者属性是只读的。
DSSI_IS_ROOT
0x00000010
对象是根对象。
DSSI_NO_FILTER
0x00000020
请勿应用任何筛选器。
DSSI_NO_READONLY_MESSAGE
0x00000040
禁止显示只读弹出消息。

[out] ppSI

指向此函数创建的 ISecurityInformation 接口实例的指针。

[in, optional] pfnReadSD

指向用于读取对象 安全描述符 的函数的指针。 此值可以为 NULL。 如果 pfnReadSD 不为 NULLDSCreateISecurityInfoObject 将调用 pfnReadSD 引用的函数来检索对象的安全描述符。

[in, optional] pfnWriteSD

指向用于编写对象安全描述符的函数的指针。 此值可以为 NULL。 如果 pfnWriteSD 不为 NULLDSCreateISecurityInfoObject 将调用 pfnWriteSD 引用的函数来编写对象的安全描述符。

[in] lpContext

要传递给 由 pfnReadSDpfnWriteSD 参数标识的函数的上下文。

返回值

如果函数成功,该函数将返回S_OK。

如果函数失败,它将返回一个 指示错误的 HRESULT 值。 有关常见错误代码的列表,请参阅 通用 HRESULT 值

要求

   
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 dssec.h
Library DSSec.lib
DLL DSSec.dll