IURLSearchHook::Metode terjemahan (shlobj_core.h)

Artikel
08/26/2023

Dipanggil oleh browser ketika browser tidak dapat menentukan protokol alamat URL.

Sintaks

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

Parameter

[out] pwszSearchURL

Jenis: PWSTR

Alamat buffer karakter lebar yang, pada entri, berisi alamat URL yang browsernya mencoba menentukan protokol. Saat keluar, buffer ini berisi alamat URL yang dimodifikasi jika metode berhasil. Lihat nilai yang dikembalikan untuk informasi selengkapnya.

cchBufferSize

Jenis: DWORD

Ukuran, dalam karakter, dari buffer di pwszSearchURL.

Menampilkan nilai

Jenis: HRESULT

Metode ini harus mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Alamat URL sepenuhnya diterjemahkan. Parameter lpwszSearchURL berisi alamat URL lengkap. Browser tidak akan memanggil HOOK Pencarian URL lainnya dan akan mencoba menelusuri ke alamat yang dimodifikasi.
S_FALSE	Alamat URL telah diproses sebagian, tetapi terjemahan lebih lanjut masih diperlukan. Parameter lpwszSearchURL berisi hasil pemrosesan. Browser akan terus mengeksekusi url Search Hooks lainnya.
E_FAIL	Alamat URL tidak diterjemahkan. Parameter lpwszSearchURL belum dimodifikasi. Browser akan terus mengeksekusi url Search Hooks lainnya.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	shlobj_core.h
DLL	Shell32.dll (versi 4.71 atau yang lebih baru)

Bagikan melalui