描述
WinHttpCreateUrl功能从组件部分创建一个URL，例如主机名和路径。
C / C ++语法
BOOL WinHttpCreateUrl( LPURL_COMPONENTS lpUrlComponents, DWORD dwFlags, LPWSTR pwszUrl, LPDWORD lpdwUrlLength ); |
PowerBASIC 语法
FUNCTION WinHttpCreateUrl ( _ BYREF lpUrlComponents AS URL_COMPONENTS, _ BYVAL dwFlags AS DWORD, _ BYREF pwszUrl AS WSTRINGZ, _ BYREF lpdwUrlLength AS DWORD _ ) AS LONG |
参数
lpUrlComponents
[in]指向包含要从中创建URL的组件的URL_COMPONENTS结构的指针。
dwFlags
[in]类型DWORD的值，其中包含控制此函数操作的标志。这可以是以下值：
ICU_ESCAPE
lpszUrlPath成员指向的路径字符串中的所有不安全字符转换为相应的转义序列，lpszExtraInfolpUrlComponents参数指向的URL_COMPONENTS结构的成员指向的额外信息字符串。
pwszUrl
[out]指向以宽字符（Unicode）字符串接收URL的字符缓冲区的指针。
lpdwUrlLength
[in, out]指向类型为unsigned long integer的变量的指针，该变量以宽（Unicode）字符接收pwszUrl缓冲区的长度。当函数返回时，该参数接收字符串宽度的字符长度，终止字符减1。如果GetLastError返回ERROR_INSUFFICIENT_BUFFER，此参数将接收保存创建的URL所需的宽字符数。
返回值
如果函数成功，则返回TRUE，否则返回FALSE。要获取扩展错误信息，请调用GetLastError.返回的错误代码有：
错误代码 |
描述 |
ERROR_WINHTTP_INTERNAL_ERROR |
发生内部错误。 |
ERROR_NOT_ENOUGH_MEMORY |
没有足够的内存来完成请求的操作。（Windows错误代码） |
备注
即使在异步模式下使用WinHTTP，也就是说，当在WinHttpOpen中设置了WINHTTP_FLAG_ASYNC时，此函数同步运行。返回值表示成功或失败。要获取扩展错误数据，请调用GetLastError.