Condividi tramite


Funzione UrlHashA (shlwapi.h)

Hash di una stringa URL.

Sintassi

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

Parametri

[in] pszUrl

Tipo: PCTSTR

Stringa con terminazione Null di lunghezza massima INTERNET_MAX_URL_LENGTH che contiene l'URL.

[out] pbHash

Tipo: BYTE*

Puntatore a un buffer che, quando questa funzione viene restituita correttamente, riceve la matrice con hash.

cbHash

Tipo: DWORD

Numero di elementi nella matrice in corrispondenza di pbHash. Non deve essere maggiore di 256.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT.

Osservazioni

Per eseguire l'hashing di un URL in un singolo byte, impostare cbHash = sizeof(BYTE) e pbHash = (LPBYTE)&bHashedValue, dove bHashedValue è un buffer a un byte. Per eseguire l'hashing di un URL in un DWORD, impostare cbHash = sizeof(DWORD) e pbHash = (LPBYTE)&dwHashedValue, dove dwHashedValue è un buffer DWORD.

Nota

L'intestazione shlwapi.h definisce UrlHash come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
client minimo supportato Windows 2000 Professional, Windows XP [solo app desktop]
server minimo supportato Windows 2000 Server [solo app desktop]
piattaforma di destinazione Finestre
intestazione shlwapi.h
libreria Shlwapi.lib
dll Shlwapi.dll (versione 5.0 o successiva)

Vedere anche

HashData