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 接口的新实例关联的安全属性页的标志。 此参数可以是以下标志的任意组合。

[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 值。

要求