Функция UrlHashW (shlwapi.h)

Статья
11/20/2024

Хэширует строку URL-адреса.

Синтаксис

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

Параметры

[in] pszUrl

Тип: PCTSTR

Строка, завершающаяся значением NULL, INTERNET_MAX_URL_LENGTH максимальной длины, содержащей URL-адрес.

[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 как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный, Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	shlwapi.h
библиотеки	Shlwapi.lib
DLL	Shlwapi.dll (версия 5.0 или более поздняя версия)

См. также

HashData

Поделиться через