ADsPropGetInitInfo 函数 (adsprop.h)

  • 项目

ADsPropGetInitInfo 函数用于获取Active Directory 域服务属性表扩展适用的目录对象数据。

语法

BOOL ADsPropGetInitInfo(
  [in]  HWND               hNotifyObj,
  [out] PADSPROPINITPARAMS pInitParams
);

参数

[in] hNotifyObj

通知对象的句柄。 若要获取此句柄，请调用 ADsPropCreateNotifyObj。

[out] pInitParams

指向接收目录对象数据的 ADSPROPINITPARAMS 结构的指针。 在调用此函数之前，必须输入此结构的 dwSize 成员。

返回值

如果成功，则返回非零值，否则返回零。

注解

pwzCN 和 pWritableAttrs 成员的内存由 ADsPropGetInitInfo 函数分配。 销毁所有属性表对象后，系统会释放此内存。 pDsObj 中接口指针的引用计数不会通过调用 ADsPropGetInitInfo 递增，因此调用方不得释放接口。

对于多选属性表，系统仅绑定到 DSOBJECT 数组中的第一个对象。 因此， ADsPropGetInitInfo 仅为数组中的第一个对象提供 IDirectoryObject 和可写属性。 数组中的其他对象未绑定到。

示例

下面的代码示例演示如何使用 ADsPropGetInitInfo 函数。

HRESULT GetADsPageInfo(HWND hwndNotifyObject, ADSPROPINITPARAMS *pip)
{
    if((NULL == pip) || (!IsWindow(hwndNotifyObject)))
    {
        return E_INVALIDARG;
    }

    ADSPROPINITPARAMS   InitParams;
    
    InitParams.dwSize = sizeof(ADSPROPINITPARAMS);
    if(ADsPropGetInitInfo(hwndNotifyObject, &InitParams))
    {
        *pip = InitParams;
    
        return InitParams.hr;
    }
    
    return E_FAIL;
}

要求

要求 值
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 adsprop.h
Library Dsprop.lib
DLL Dsprop.dll

另请参阅

ADSPROPINITPARAMS

ADsPropCreateNotifyObj