共用方式為

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
程式庫 Dsprop.lib
Dll Dsprop.dll

另請參閱

ADSPROPINITPARAMS

ADsPropCreateNotifyObj