URLAssociationDialogA 函式 (intshcut.h)
叫用未註冊的 URL 通訊協定對話方塊。 此對話框可讓用戶選取要與先前未知通訊協定相關聯的應用程式。
注意 Windows XP Service Pack 2 (SP2) 或更新版本:不再支援此函式。
語法
INTSHCUTAPI HRESULT URLAssociationDialogA(
HWND hwndParent,
DWORD dwInFlags,
PCSTR pcszFile,
PCSTR pcszURL,
[out] PSTR pszAppBuf,
UINT ucAppBufLen
);
參數
hwndParent
類型: HWND
父視窗的句柄。
dwInFlags
類型: DWORD
指定函式行為的位旗標。 此值可以是下列各項的組合:
URLASSOCDLG_FL_USE_DEFAULT_NAME
使用默認檔名 (,也就是 “Internet Shortcut”) 。
URLASSOCDLG_FL_REGISTER_ASSOC
將選取的應用程式註冊為 pcszURL中所指定通訊協議的處理程式。 只有在設定此旗標且使用者指出需要持續關聯時,才會註冊應用程式。
pcszFile
類型: HTTPSTR
常數零終止字串的位址,其中包含要與 URL 通訊協定相關聯的檔名。
pcszURL
類型: HTTPSTR
包含具有未知通訊協定之 URL 的常數零終止字串位址。
[out] pszAppBuf
類型: PTSTR
接收使用者指定之應用程式路徑的緩衝區位址。
ucAppBufLen
類型: UINT
pszAppBuf 的大小,以字元為單位。
傳回值
類型: HRESULT
注意 自 Windows XP SP2 起,此函式不受支援,且在所有情況下都會傳回E_NOTIMPL。
備註
注意
intshcut.h 標頭會將 URLAssociationDialog 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | intshcut.h |
Dll | Url.dll |