通过

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

使用默认文件名（即“Internet 快捷方式”）。

URLASSOCDLG_FL_REGISTER_ASSOC

将所选应用程序注册为 pcszURL中指定的协议的处理程序。 仅当设置此标志并且用户指示需要持久关联时，才会注册应用程序。

pcszFile

类型：

包含要与 URL 协议关联的文件名的常量零终止字符串的地址。

pcszURL

类型：

包含具有未知协议的 URL 的常量零终止字符串的地址。

[out] pszAppBuf

类型：PTSTR

接收用户指定的应用程序的路径的缓冲区的地址。

ucAppBufLen

类型：UINT

pszAppBuf的大小（以字符为单位）。

返回值

类型：HRESULT

Note Windows XP SP2， this function not supported and returns E_NOTIMPL in all situations.
 
在受支持的系统中，如果应用程序已注册到 URL 协议，则返回S_OK;如果未注册任何内容，则返回S_FALSE。 例如，当用户选择通过所选应用程序执行一次性执行时，该函数将返回S_FALSE。

言论

注意

intshcut.h 标头将 URLAssociationDialog 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows XP [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 intshcut.h
DLL Url.dll