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


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

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

Синтаксис

LWSTDAPI UrlHashA(
  [in]  PCSTR 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 Professional, Windows XP [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header shlwapi.h
Библиотека Shlwapi.lib
DLL Shlwapi.dll (версия 5.0 или более поздняя)

См. также раздел

HashData