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
次のいずれかの値を返します。
リターン コード | 説明 |
---|---|
|
デスクトップアイテムを追加できませんでした。または、デスクトップアイテムのインスタンスがアクティブデスクトップに既に存在しています。 |
|
1 つ以上のパラメーターが無効でした。 |
|
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 以降) |