通过

ParseURLW 函数 （shlwapi.h）

  • 项目

对 URL 执行基本的分析。

语法

LWSTDAPI ParseURLW(
  [in]      LPCWSTR    pcszURL,
  [in, out] PARSEDURLW *ppu
);

参数

[in] pcszURL

类型：LPCTSTR

指向包含要分析的 URL 的以 null 结尾的字符串的指针。

[in, out] ppu

类型：PARSEDURL*

指向接收已分析结果的 PARSEDURL 结构的指针。 调用应用程序必须先将结构的 cbSize 成员设置为结构的大小，然后才能调用 ParseURL。

返回值

类型：HRESULT

返回成功时 S_OK，否则返回 COM 错误代码。 如果字符串无法解析为 URL，该函数将返回 URL_E_INVALID_SYNTAX（在 Intshcut.h 中定义）。

言论

ParseURL 执行的分析相当简单。 若要进行更复杂的 URL 分析，请使用 InternetCrackUrl。

例子

此示例控制台应用程序使用 ParseURL 来分析多个简单 URL。

#include <windows.h>
#include <shlwapi.h>
#include <stdio.h>
#include <tchar.h>

void sample(LPCTSTR pcszUrl)
{
    PARSEDURL pu;
    pu.cbSize = sizeof(pu);
    HRESULT hr = ParseURL(pcszUrl, &pu);
    _tprintf(TEXT("ParseURL(%s) returned 0x%08x\n"), pcszUrl, hr);
    if (SUCCEEDED(hr)) {
        _tprintf(TEXT("Protocol = %.*s\n"), pu.cchProtocol, pu.pszProtocol);
        _tprintf(TEXT("Suffix   = %.*s\n"), pu.cchSuffix, pu.pszSuffix);
        _tprintf(TEXT("Scheme   = %d\n"), pu.nScheme);
        _tprintf(TEXT("\n"));
    }
}

int __cdecl main()
{
    sample(TEXT("http://msdn.microsoft.com/vstudio/"));
    sample(TEXT("mailto:someone@example.com"));
    sample(TEXT("file://C:\\AUTOEXEC.BAT"));
    sample(TEXT("C:\\AUTOEXEC.BAT"));
    return 0;
}

输出：

ParseURL(http://msdn.microsoft.com/vstudio/) returned 0x00000000
Protocol = http
Suffix   = //msdn.microsoft.com/vstudio/
Scheme   = 2

ParseURL(mailto:someone@example.com) returned 0x00000000
Protocol = mailto
Suffix   = someone@example.com
Scheme   = 4

ParseURL(file://C:\AUTOEXEC.BAT) returned 0x00000000
Protocol = file
Suffix   = C:\AUTOEXEC.BAT
Scheme   = 9

ParseURL(C:\AUTOEXEC.BAT) returned 0x80041001

注意

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

要求

要求 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 shlwapi.h
DLL Shlwapi.dll（版本 6.0.1 或更高版本）