IURLSearchHook::Translate-Methode (shlobj_core.h)

Artikel
08/26/2023

Wird vom Browser aufgerufen, wenn der Browser das Protokoll einer URL-Adresse nicht ermitteln kann.

Syntax

HRESULT Translate(
  [out] PWSTR pwszSearchURL,
        DWORD cchBufferSize
);

Parameter

[out] pwszSearchURL

Typ: PWSTR

Die Adresse eines Breitenzeichenpuffers, der bei der Eingabe die URL-Adresse enthält, für die der Browser versucht, das Protokoll zu bestimmen. Beim Beenden enthält dieser Puffer die geänderte URL-Adresse, wenn die Methode erfolgreich war. Weitere Informationen finden Sie im Rückgabewert.

cchBufferSize

Art: DWORD

Die Größe des Puffers in Zeichen bei pwszSearchURL.

Rückgabewert

Typ: HRESULT

Diese Methode muss einen der folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die URL-Adresse wurde vollständig übersetzt. Der parameter lpwszSearchURL enthält die vollständige URL-Adresse. Der Browser ruft keine anderen URL-Suchhaken auf und versucht, zu der geänderten Adresse zu navigieren.
S_FALSE	Die URL-Adresse wurde teilweise verarbeitet, aber eine weitere Übersetzung ist noch erforderlich. Der lpwszSearchURL-Parameter enthält das Ergebnis der Verarbeitung. Der Browser führt den Rest der URL-Such-Hooks weiter aus.
E_FAIL	Die URL-Adresse wurde nicht übersetzt. Der lpwszSearchURL-Parameter wurde nicht geändert. Der Browser führt den Rest der URL-Such-Hooks weiter aus.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlobj_core.h
DLL	Shell32.dll (Version 4.71 oder höher)

Share via