Condividi tramite

Metodo IURLSearchHook::Translate (shlobj_core.h)

  • Articolo

Chiamato dal browser quando il browser non è in grado di determinare il protocollo di un indirizzo URL.

Sintassi

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

Parametri

[out] pwszSearchURL

Tipo: PWSTR

L'indirizzo di un buffer di caratteri wide che, nella voce, contiene l'indirizzo URL per cui il browser sta tentando di determinare il protocollo. All'uscita, questo buffer contiene l'indirizzo URL modificato se il metodo ha avuto esito positivo. Per altre informazioni, vedere il valore restituito.

cchBufferSize

Tipo: DWORD

Dimensioni, in caratteri, del buffer in pwszSearchURL.

Valore restituito

Tipo: HRESULT

Questo metodo deve restituire uno dei valori seguenti.

Codice restituito Descrizione
S_OK
 L'indirizzo URL è stato tradotto completamente. Il parametro lpwszSearchURL contiene l'indirizzo URL completo. Il browser non chiamerà altri hook di ricerca URL e tenterà di passare all'indirizzo modificato.
S_FALSE
 L'indirizzo URL è stato elaborato parzialmente, ma è ancora necessaria un'ulteriore traduzione. Il parametro lpwszSearchURL contiene il risultato dell'elaborazione. Il browser continuerà a eseguire il resto degli hook di ricerca URL.
E_FAIL
 L'indirizzo URL non è stato convertito. Il parametro lpwszSearchURL non è stato modificato. Il browser continuerà a eseguire il resto degli hook di ricerca URL.

Requisiti

   
Client minimo supportato Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shlobj_core.h
DLL Shell32.dll (versione 4.71 o successiva)