次の方法で共有

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 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー intshcut.h
DLL Url.dll