Função UrlHashW (shlwapi.h)

Artigo
11/20/2024

Hashes uma cadeia de caracteres de URL.

Sintaxe

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

Parâmetros

[in] pszUrl

Tipo: PCTSTR

Uma cadeia de caracteres terminada em nulo de comprimento máximo INTERNET_MAX_URL_LENGTH que contém a URL.

[out] pbHash

Tipo: BYTE*

Um ponteiro para um buffer que, quando essa função retorna com êxito, recebe a matriz hash.

cbHash

Tipo: DWORD

O número de elementos na matriz em pbHash. Não deve ser maior que 256.

Valor de retorno

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Observações

Para colocar uma URL em um único byte, defina cbHash = sizeof(BYTE) e pbHash = (LPBYTE)&bHashedValue, em que bHashedValue é um buffer de um byte. Para colocar uma URL em umde DWORD , defina cbHash = sizeof(DWORD) e pbHash = (LPBYTE)&dwHashedValue, em que dwHashedValue é um buffer DWORD.

Nota

O cabeçalho shlwapi.h define UrlHash como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	shlwapi.h
biblioteca	Shlwapi.lib
de DLL	Shlwapi.dll (versão 5.0 ou posterior)

Consulte também

HashData

Compartilhar via