次の方法で共有


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

指定した URL に関連付けられているデスクトップ項目を追加します。

構文

HRESULT AddUrl(
  [in, optional] HWND        hwnd,
  [in]           PCWSTR      pszSource,
  [in]           LPCOMPONENT pcomp,
                 DWORD       dwFlags
);

パラメーター

[in, optional] hwnd

型: HWND

ユーザー インターフェイスの親ウィンドウへのハンドル。

[in] pszSource

種類: PCWSTR

デスクトップ項目の URL を含む文字列へのポインター。

[in] pcomp

型: LPCOMPONENT

追加するデスクトップ項目の詳細を含む COMPONENT 構造体へのポインター。

dwFlags

型: DWORD

このメソッドを制御する符号なし long 整数値。 ユーザー インターフェイスを表示せずにデスクトップ項目を追加するには、ADDURL_SILENTに設定できます。

戻り値

種類: HRESULT

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

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

注釈

既定では、このメソッドはユーザー インターフェイスを表示し、デスクトップ項目を Active Desktop に追加します。 IActiveDesktop::AddDesktopItem と同様に、変更をレジストリに保存するには、クライアント アプリケーションで IActiveDesktop::ApplyChanges を呼び出す必要があります。

要件

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

こちらもご覧ください

IActiveDesktop

アクティブ デスクトップ オブジェクトの使用