InternetCreateUrlA 函数 (wininet.h)

  • 项目

从其组件部件创建 URL。

语法

BOOL InternetCreateUrlA(
  [in]      LPURL_COMPONENTSA lpUrlComponents,
  [in]      DWORD             dwFlags,
  [out]     LPSTR             lpszUrl,
  [in, out] LPDWORD           lpdwUrlLength
);

参数

[in] lpUrlComponents

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

[in] dwFlags

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

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

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

[out] lpszUrl

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

[in, out] lpdwUrlLength

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

返回值

如果函数成功，则返回 TRUE ;否则返回 FALSE 。 要获得更多的错误信息，请调用 GetLastError。

注解

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

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

注意

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

要求

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

另请参阅

处理统一资源定位符

WinINet 函数