DSCreateISecurityInfoObjectEx 函数 (dssec.h)

  • 项目

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

语法

HRESULT DSCreateISecurityInfoObjectEx(
  [in]           LPCWSTR                pwszObjectPath,
  [in]           LPCWSTR                pwszObjectClass,
  [in]           LPCWSTR                pwszServer,
  [in]           LPCWSTR                pwszUserName,
  [in]           LPCWSTR                pwszPassword,
  [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] pwszServer

由 pwszObjectPath 参数指定的 对象的服务器。 如果此参数的值为 NULL，则从 pwszObjectPath 参数指定的路径获取服务器。

[in] pwszUserName

要与新的 ISecurityInformation 对象关联的用户名。 如果此参数的值为 NULL，则使用 active Directory 服务接口 (ADSI) 默认值。

[in] pwszPassword

要与新的 ISecurityInformation 对象关联的密码。 如果此参数的值为 NULL，则使用 active Directory 服务接口 (ADSI) 默认值。

[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 不为 NULL， DSCreateISecurityInfoObject 将调用 pfnReadSD 引用的函数来检索对象的安全描述符。

[in, optional] pfnWriteSD

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

[in] lpContext

要传递给 由 pfnReadSD 和 pfnWriteSD 参数标识的函数的上下文。

返回值

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

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

要求

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