Función UrlHashA (shlwapi.h)

Aplica un algoritmo hash a una cadena de dirección URL.

Sintaxis

LWSTDAPI UrlHashA(
  [in]  PCSTR pszUrl,
  [out] BYTE  *pbHash,
        DWORD cbHash
);

Parámetros

[in] pszUrl

Tipo: PCTSTR

Cadena terminada en null de longitud máxima INTERNET_MAX_URL_LENGTH que contiene la dirección URL.

[out] pbHash

Tipo: BYTE*

Puntero a un búfer que, cuando esta función vuelve correctamente, recibe la matriz con hash.

cbHash

Tipo: DWORD de

Número de elementos de la matriz en pbHash. No debe ser mayor que 256.

Valor devuelto

Tipo: HRESULT

Si esta función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un hrESULT código de error.

Observaciones

Para aplicar un hash a una dirección URL en un solo byte, establezca cbHash = sizeof(BYTE) y pbHash = (LPBYTE)&bHashedValue, donde bHashedValue es un búfer de un solo byte. Para aplicar un hash a una dirección URL en unaDWORD de , establezca cbHash = sizeof(DWORD) y pbHash = (LPBYTE)&dwHashedValue, donde dwHashedValue es un búfer DWORD .

Nota

El encabezado shlwapi.h define UrlHash como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	shlwapi.h
biblioteca de	Shlwapi.lib
DLL de	Shlwapi.dll (versión 5.0 o posterior)

Consulte también

hashData