URLAssociationDialogW 関数 (intshcut.h)

  • [アーティクル]

登録されていない URL プロトコル ダイアログ ボックスを呼び出します。 このダイアログ ボックスを使用すると、ユーザーは、以前に不明なプロトコルに関連付けるアプリケーションを選択できます。

メモ Windows XP Service Pack 2 (SP2) 以降: この関数はサポートされなくなりました。
 

構文

INTSHCUTAPI HRESULT URLAssociationDialogW(
        HWND   hwndParent,
        DWORD  dwInFlags,
        PCWSTR pcszFile,
        PCWSTR pcszURL,
  [out] PWSTR  pszAppBuf,
        UINT   ucAppBufLen
);

パラメーター

hwndParent

型: HWND

親ウィンドウへのハンドル。

dwInFlags

型: DWORD

関数の動作を指定するビット フラグ。 この値には、次の組み合わせを指定できます。

URLASSOCDLG_FL_USE_DEFAULT_NAME

既定のファイル名 ("インターネット ショートカット" ) を使用します。

URLASSOCDLG_FL_REGISTER_ASSOC

選択したアプリケーションを pcszURL で指定されたプロトコルのハンドラーとして登録します。 アプリケーションは、このフラグが設定され、ユーザーが永続的な関連付けが必要であることを示す場合にのみ登録されます。

pcszFile

種類: PTSTR

URL プロトコルに関連付けるファイル名を含む、0 で終わる定数文字列のアドレス。

pcszURL

種類: PTSTR

プロトコルが不明な URL を含む、0 で終わる定数文字列のアドレス。

[out] pszAppBuf

種類: PTSTR

ユーザーが指定したアプリケーションのパスを受け取るバッファーのアドレス。

ucAppBufLen

型: UINT

pszAppBuf のサイズ (文字単位)。

戻り値

種類: HRESULT

メモ Windows XP SP2 の時点では、この関数はサポートされておらず、すべての状況でE_NOTIMPLを返します。
 
サポートされているシステムでは、アプリケーションが URL プロトコルに登録されている場合はS_OKを返し、何も登録されていない場合はS_FALSEを返します。 たとえば、 関数は、ユーザーが選択したアプリケーションを介して 1 回限りの実行を実行することを選択すると、S_FALSEを返します。

解説

Note

intshcut.h ヘッダーは、URLAssociationDialog をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー intshcut.h
[DLL] Url.dll