通过

InternetCreateUrlW 函数 （wininet.h）

  • 项目

从其组件部件创建 URL。

语法

BOOL InternetCreateUrlW(
  [in]      LPURL_COMPONENTSW lpUrlComponents,
  [in]      DWORD             dwFlags,
  [out]     LPWSTR            lpszUrl,
  [in, out] LPDWORD           lpdwUrlLength
);

参数

[in] lpUrlComponents

指向包含从中创建 URL 的组件的 URL_COMPONENTS 结构的指针。

[in] dwFlags

控制此函数的操作。 此参数可以是以下一个或多个值。

价值 意义
ICU_ESCAPE
 将所有不安全字符转换为由 lpszUrlPath 成员指向的路径字符串中的相应转义序列，并在 lpszExtraInfo 中 由 lpUrlComponents 参数指向 URL_COMPONENTS 结构的成员指向的额外信息字符串。

InternetCreateUrl 的 Unicode 版本将首先尝试使用系统代码页进行转换。 如果失败，它将回退到 UTF-8。
ICU_USERNAME
 已过时 - 已忽略。

[out] lpszUrl

指向接收 URL 的缓冲区的指针。

[in, out] lpdwUrlLength

指向指定 URL lpszUrl 缓冲区大小（TCHAR）的变量的指针。 函数返回时，此参数将接收 URL 字符串的大小，不包括 NULL 终止符。 如果 GetLastError 返回ERROR_INSUFFICIENT_BUFFER，此参数将接收保存创建的 URL 所需的字节数。

返回值

如果函数成功，则返回 TRUE;否则返回 FALSE。 若要获取扩展的错误信息，请调用 GetLastError。

言论

在传递给 lpUrlComponents的 URL_COMPONENTS 结构中指定方案时，如果 lpszScheme 不是 NULL，则它将用于方案。 如果 lpszScheme 为 NULL，则可以使用 INTERNET_SCHEME 枚举指定方案，方法是将 nScheme 设置为所需的 INTERNET_SCHEME 或 INTERNET_SCHEME_DEFAULT。

注意 WinINet 不支持服务器实现。 此外，不应从服务使用它。 对于服务器实现或服务，请使用 Microsoft Windows HTTP 服务（WinHTTP）。
 

注意

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

要求

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

另请参阅

处理统一资源定位符

WinINet 函数