共用方式為

MIMEAssociationDialogA 函式 （intshcut.h）

  • 發行項

執行未註冊的MIME內容類型對話框。

注意 Windows XP Service Pack 2 （SP2） 或更新版本：不再支援此函式。
 

語法

INTSHCUTAPI HRESULT MIMEAssociationDialogA(
        HWND  hwndParent,
        DWORD dwInFlags,
        PCSTR pcszFile,
        PCSTR pcszMIMEContentType,
  [out] PSTR  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
 其中一個輸入指標無效。

言論

此函式不會在pcszMIMEContentType 驗證輸入內容類型字串的語法。 成功的傳回值不表示指定的MIME內容類型有效。

注意

intshcut.h 標頭會根據 UNICODE 預處理器常數的定義，將 MIMEAssociationDialog 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 intshcut.h
DLL Url.dll