InternetCrackUrlA 函数（wininet.h）

项目
11/20/2024

将 URL 破解到其组件部件中。

语法

BOOL InternetCrackUrlA(
  [in]      LPCSTR            lpszUrl,
  [in]      DWORD             dwUrlLength,
  [in]      DWORD             dwFlags,
  [in, out] LPURL_COMPONENTSA lpUrlComponents
);

参数

[in] lpszUrl

指向包含要破解的规范 URL 的字符串的指针。

[in] dwUrlLength

lpszUrl 字符串的大小（TCHAR），如果 lpszUrl 为 ASCIIZ 字符串，则为零。

[in] dwFlags

控制操作。此参数可以是下列值之一。

价值	意义
ICU_DECODE	将编码的字符转换回其普通形式。仅当用户在 URL_COMPONENTS 结构中提供缓冲区以将组件复制到该结构时，才能使用此缓冲区。
ICU_ESCAPE	将所有转义序列（%xx）转换为其相应的字符。仅当用户在 URL_COMPONENTS 结构中提供缓冲区以将组件复制到该结构时，才能使用此缓冲区。

[in, out] lpUrlComponents

指向接收 URL 组件的 URL_COMPONENTS 结构的指针。

返回值

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

言论

所需组件由 URL_COMPONENTS 结构的成员指示。每个组件都有一个指向该值的指针，并具有存储存储值的长度的成员。如果组件的值和长度都等于零，则不会返回该组件。 Windows Vista 及更高版本。如果指向组件的值的指针 NULL 且其相应长度成员的值不为零，则 lpszUrl 字符串中相应组件的第一个字符的地址存储在指针中，并且组件长度存储在长度成员中。

如果指针包含用户提供的缓冲区的地址，长度成员必须包含缓冲区的大小。 InternetCrackUrl 将组件复制到缓冲区中，长度成员设置为复制的组件的长度，尾随字符串终止符减去 1。

若要 InternetCrackUrl 正常工作，URL_COMPONENTS 结构的大小（以字节为单位）必须存储在 dwStructSize 成员中。

注释不要在包含空格的“file://”URL 上使用 InternetCrackUrl，因为 dwUrlPathLength 成员所指向的 URL_COMPONENTS 结构 的值太大。但是，只有包含空格字符的“file://”URL 才如此。

与 WinINet API 的其他所有方面一样，不能从 DllMain 或全局对象的构造函数和析构函数中安全地调用此函数。

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

注意

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

要求

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