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

[アーティクル]
08/26/2023

デスクトップ項目の追加を確認するユーザーインターフェイスを表示し、セキュリティゾーンのアクセス許可を確認し、ユーザーがサブスクリプションを作成するかどうかを確認した後、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

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

リターンコード	説明
E_FAIL	デスクトップ項目を追加できませんでした。または、デスクトップ項目のインスタンスが Active Desktop に既に存在します。
E_INVAILDARG	1 つ以上のパラメーターが無効でした。
S_OK	ADDURL_SILENT フラグが設定されている場合は、デスクトップ項目が正常に追加されたか、Active Desktop に既に存在します。それ以外の場合は、デスクトップ項目が正常に追加されました。

注釈

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

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	shlobj_core.h
[DLL]	Shell32.dll (バージョン 4.71 以降)

こちらもご覧ください

IActiveDesktop

Active Desktop オブジェクトの使用

次の方法で共有