internetCrackUrlA 函数 (wininet.h)

项目
03/04/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 字符串中相应组件的第一个字符的地址存储在指针中，而组件的长度存储在 length 成员中。

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

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

注意不要对包含空格的“file://”URL 使用 InternetCrackUrl，因为 lpUrlComponents 指向的 URL_COMPONENTS 结构的 dwUrlPathLength 成员中返回的值太大。但是，只有包含空格字符的“file://”URL 才属于这种情况。

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

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

注意

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

要求

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