MIMEAssociationDialogW 関数 (intshcut.h)

  • [アーティクル]

未登録の MIME コンテンツ タイプ ダイアログ ボックスを実行します。

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

構文

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

パラメーター

hwndParent

型: HWND

投稿された子ウィンドウの親ウィンドウへのハンドル。

dwInFlags

型: DWORD

関連付けを登録するかどうかを指定するビット フラグ値。 ビット フラグは、MIMEASSOCDLG_FL_REGISTER_ASSOC (0x0001) の値です。 このビットが設定されている場合、選択したアプリケーションは、指定された MIME の種類のハンドラーとして登録されます。 このビットが明確な場合、関連付けは登録されません。

アプリケーションは、このフラグが設定され、永続的な関連付けが行われるとユーザーが示している場合にのみ登録されます。

pcszFile の文字列に拡張子が含まれていない場合、登録は不可能です。

pcszFile

種類: PCTSTR

ターゲット ファイルの名前を含む null で終わる文字列のアドレス。 このファイルは 、pcszMIMEContentType パラメーターで記述されたコンテンツ タイプに準拠している必要があります。

pcszMIMEContentType

種類: PCTSTR

登録されていないコンテンツ タイプを含む null で終わる文字列のアドレス。

[out] pszAppBuf

種類: PTSTR

この関数が正常に返されるときに、ユーザーによって指定されたアプリケーションのパスを受け取るバッファーへのポインター。

ucAppBufLen

型: UINT

pszAppBuf のサイズ (文字数)。

戻り値

型: HRESULT

メモ Windows XP SP2 の時点では、この関数はサポートされておらず、すべての状況でE_NOTIMPLを返します。
 
サポートされているシステムでは、 は、コンテンツ タイプが拡張機能に正常に関連付けられた場合にS_OKを返します。 この場合、拡張機能はコンテンツ タイプの既定値として関連付けられます。 pszAppBuf は、指定されたアプリケーションのパスを含む文字列を指します。 何も登録されていない場合、関数はS_FALSEを返します。 それ以外の場合、戻り値は次のいずれかになります。
リターン コード 説明
E_ABORT
 ユーザーが操作を取り消しました。
E_FLAGS
 dwInFlags で渡されたフラグの組み合わせが無効です。
E_OUTOFMEMORY
 操作を完了するために使用できるメモリが不足していました。
E_POINTER
 入力ポインターの 1 つが無効です。

注釈

この関数は、 pcszMIMEContentType での入力コンテンツ タイプ文字列の構文を検証しません。 成功した戻り値は、指定された MIME コンテンツ タイプが有効であることを示していません。

注意

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

要件

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