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。 否則，傳回值會是下列其中一項：

傳回碼	Description
E_ABORT	使用者已取消作業。
E_FLAGS	傳入 dwInFlags 的旗標組合無效。
E_OUTOFMEMORY	記憶體不足，無法完成作業。
E_POINTER	其中一個輸入指標無效。

備註

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

注意

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

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	intshcut.h
Dll	Url.dll