MIMEAssociationDialogA 函式 (intshcut.h)
執行未註冊的MIME內容類型對話框。
語法
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
傳回碼 | Description |
---|---|
|
使用者已取消作業。 |
|
傳入 dwInFlags 的旗標組合無效。 |
|
記憶體不足,無法完成作業。 |
|
其中一個輸入指標無效。 |
備註
此函式不會驗證 pcszMIMEContentType上輸入內容類型字串的語法。 成功的傳回值不表示指定的MIME內容類型有效。
注意
intshcut.h 標頭會將MIMEAssociationDialog定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | intshcut.h |
Dll | Url.dll |