IActiveDesktop::AddDesktopItemWithUI メソッド (shlobj_core.h)

デスクトップ項目の追加を確認するユーザー インターフェイスを表示し、セキュリティ ゾーンのアクセス許可を確認し、ユーザーがサブスクリプションを作成するかどうかを確認した後、Active Desktop にデスクトップ項目を追加します。

構文

HRESULT AddDesktopItemWithUI(
  [in, optional] HWND        hwnd,
  [in]           LPCOMPONENT pcomp,
                 DWORD       dwReserved
);

パラメーター

[in, optional] hwnd

型: HWND

親ウィンドウのハンドル。 NULL の場合、対応するセキュリティ ゾーンのアクセス許可に従って、ユーザー インターフェイスを表示せずにデスクトップ項目が追加されます。 詳細については、「 URL セキュリティ ゾーンについて」を参照してください。

[in] pcomp

種類: LPCOMPONENT

追加するデスクトップ項目の詳細を含む COMPONENT 構造体のアドレス。

dwReserved

型: DWORD

デスクトップ項目の追加方法を制御するフラグを含む符号なし long 整数値。 次のいずれかの値を指定できます。

DTI_ADDUI_DEFAULT

既定のアクションを実行します。 ゼロの使用と同じです。

DTI_ADDUI_DISPSUBWIZARD

サブスクリプション ウィザードをアクティブ化して、ユーザーがこのデスクトップ アイテムをサブスクライブできるようにします。

DTI_ADDUI_POSITIONITEM

COMPONENT 構造体の cpPos メンバーに渡される COMPPOS 構造体を調び、値が妥当な制限内にあることを確認するようにシステムに指示します。 この値は、インターネット エクスプローラー 5 に追加されました。

戻り値

型: HRESULT

次のいずれかの値を返します。

注釈

このメソッドは、デスクトップ項目を追加する Active Desktop の 2 番目のインスタンスを作成します。そのため、デスクトップ項目は現在のインスタンスに表示されません。 アプリケーションは、この IActiveDesktop インターフェイスで IUnknown::Release メソッドを呼び出し、CoCreateInstance 関数を使用して、新しく追加されたコンポーネントを含む Active Desktop オブジェクトを取得する必要があります。

要件

こちらもご覧ください

IActiveDesktop

Active Desktop オブジェクトの使用