URLAssociationDialogW 函式 (intshcut.h)

  • 發行項

叫用未註冊的 URL 通訊協定對話方塊。 此對話方塊可讓使用者選取應用程式，以與先前未知的通訊協定產生關聯。

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

語法

INTSHCUTAPI HRESULT URLAssociationDialogW(
        HWND   hwndParent,
        DWORD  dwInFlags,
        PCWSTR pcszFile,
        PCWSTR pcszURL,
  [out] PWSTR  pszAppBuf,
        UINT   ucAppBufLen
);

參數

hwndParent

類型： HWND

父視窗的控制碼。

dwInFlags

類型： DWORD

指定函式行為的位旗標。 此值可以是下列各項的組合：

URLASSOCDLG_FL_USE_DEFAULT_NAME

使用預設檔案名 (，也就是「網際網路快捷方式」) 。

URLASSOCDLG_FL_REGISTER_ASSOC

將選取的應用程式註冊為 pcszURL中指定的通訊協定處理常式。 只有在設定此旗標且使用者指出需要持續性關聯時，才會註冊應用程式。

pcszFile

類型： HTTPSTR

常數零終止字串的位址，其中包含要與 URL 通訊協定建立關聯的檔案名。

pcszURL

類型： HTTPSTR

常數零終止字串的位址，其中包含具有未知通訊協定的 URL。

[out] pszAppBuf

類型： PTSTR

接收使用者指定之應用程式路徑的緩衝區位址。

ucAppBufLen

類型： UINT

pszAppBuf的大小，以字元為單位。

傳回值

類型： HRESULT

注意 從 Windows XP SP2 起，此函式在所有情況下都不支援並傳回E_NOTIMPL。
 
在支援的系統中，如果應用程式已註冊 URL 通訊協定，則傳回S_OK，如果未註冊任何專案，則傳回S_FALSE。 例如，當使用者選擇透過選取的應用程式執行一次性執行時，函式會傳回S_FALSE。

備註

注意

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

需求

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