IURLSearchHook2::TranslateWithSearchContext-Methode (shlobj_core.h)

  • Artikel

Wird vom Browser aufgerufen, wenn der Browser das Protokoll einer URL-Adresse nicht ermitteln kann. Diese Methode verwendet einen Suchkontext, um das Protokoll zu bestimmen.

Syntax

HRESULT TranslateWithSearchContext(
  [out]          PWSTR          pwszSearchURL,
                 DWORD          cchBufferSize,
  [in, optional] ISearchContext *pSearchContext
);

Parameter

[out] pwszSearchURL

Typ: PWSTR

Die Adresse eines Breitzeichenpuffers, 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.

cchBufferSize

Art: DWORD

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

[in, optional] pSearchContext

Typ: ISearchContext*

Ein Zeiger auf ein ISearchContext-Objekt . Dieser Parameter kann NULL sein.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlobj_core.h
DLL Shell32.dll