Freigeben über

IURLSearchHook::Translate-Methode (shlobj_core.h)

  • Artikel

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)