urlHashW 函数 (shlwapi.h)

  • 项目

对 URL 字符串进行哈希处理。

语法

LWSTDAPI UrlHashW(
  [in]  PCWSTR pszUrl,
  [out] BYTE   *pbHash,
        DWORD  cbHash
);

参数

[in] pszUrl

类型： PCTSTR

包含 URL 的最大长度INTERNET_MAX_URL_LENGTH以 null 结尾的字符串。

[out] pbHash

类型： BYTE*

指向缓冲区的指针，当此函数成功返回时，该缓冲区接收哈希数组。

cbHash

类型：DWORD

数组中 pbHash 处的元素数。 它不应大于 256。

返回值

类型： HRESULT

如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

若要将 URL 哈希写入单个字节，请将 cbHash = sizeof (BYTE) 设置为 pbHash = (LPBYTE) &bHashedValue，其中 bHashedValue 是单字节缓冲区。 若要将 URL 哈希写入 DWORD，请将 cbHash = sizeof (DWORD) 设置为 pbHash = (LPBYTE) &dwHashedValue，其中 dwHashedValue 是 DWORD 缓冲区。

注意

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

要求

要求 值
最低受支持的客户端 Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 shlwapi.h
Library Shlwapi.lib
DLL Shlwapi.dll (5.0 或更高版本)

另请参阅

HashData