URLAssociationDialogA 関数 (intshcut.h)

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

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

 

構文

INTSHCUTAPI HRESULT URLAssociationDialogA(
        HWND  hwndParent,
        DWORD dwInFlags,
        PCSTR pcszFile,
        PCSTR pcszURL,
  [out] PSTR  pszAppBuf,
        UINT  ucAppBufLen
);

パラメーター

hwndParent

型: HWND

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

dwInFlags

型: DWORD

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

URLASSOCDLG_FL_USE_DEFAULT_NAME

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

URLASSOCDLG_FL_REGISTER_ASSOC

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

pcszFile

型: PTCSTR

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

pcszURL

型: PTCSTR

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

[out] pszAppBuf

型: PTSTR

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

ucAppBufLen

型: UINT

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

戻り値

型: HRESULT

Windows XP SP2 の時点、この関数はサポートされておらず、すべての状況でE_NOTIMPLを返します。

 

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

備考

手記

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

必要条件

要件	価値
サポートされる最小クライアント	Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	intshcut.h
DLL	Url.dll