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

要件

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