UrlHashA-Funktion (shlwapi.h)
Hasht eine URL-Zeichenfolge.
Syntax
LWSTDAPI UrlHashA(
[in] PCSTR pszUrl,
[out] BYTE *pbHash,
DWORD cbHash
);
Parameter
[in] pszUrl
Typ: PCTSTR-
Eine mit Null beendete Zeichenfolge mit maximaler Länge INTERNET_MAX_URL_LENGTH, die die URL enthält.
[out] pbHash
Typ: BYTE*-
Ein Zeiger auf einen Puffer, der, wenn diese Funktion erfolgreich zurückgegeben wird, das Hasharray empfängt.
cbHash
Typ: DWORD-
Die Anzahl der Elemente im Array bei pbHash. Es sollte nicht größer als 256 sein.
Rückgabewert
Typ: HRESULT-
Wenn diese Funktion erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben.
Bemerkungen
Um eine URL in ein einzelnes Byte zu hashen, legen Sie cbHash = sizeof(BYTE) und PbHash = (LPBYTE)&bHashedValue fest, wobei bHashedValue ein Ein-Byte-Puffer ist. Um eine URL in eine DWORD-zu hashen, legen Sie cbHash = sizeof(DWORD) und PbHash = (LPBYTE)&dwHashedValue fest, wobei dwHashedValue ein DWORD- Puffer ist.
Anmerkung
Der Header "shlwapi.h" definiert UrlHash als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional, Windows XP [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | shlwapi.h |
| Library | Shlwapi.lib |
| DLL- | Shlwapi.dll (Version 5.0 oder höher) |