ADsPropGetInitInfo 関数 (adsprop.h)

ADsPropGetInitInfo 関数は、Active Directory Domain Services プロパティ シート拡張機能が適用されるディレクトリ オブジェクト データを取得するために使用されます。

構文

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

パラメーター

[in] hNotifyObj

通知オブジェクトのハンドル。 このハンドルを取得するには、 ADsPropCreateNotifyObj を呼び出します。

[out] pInitParams

ディレクトリ オブジェクト データを受け取る ADSPROPINITPARAMS 構造体へのポインター。 この構造体の dwSize メンバーは、この関数を呼び出す前に入力する必要があります。

戻り値

成功した場合は 0 以外、それ以外の場合は 0 を返します。

注釈

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