TranslateURLA-Funktion (intshcut.h)

2024-11-20

Wendet allgemeine Übersetzungen auf eine bestimmte URL-Zeichenfolge an, wodurch eine neue URL-Zeichenfolge erstellt wird.

Syntax

INTSHCUTAPI HRESULT TranslateURLA(
        PCSTR pcszURL,
        DWORD dwInFlags,
  [out] PSTR  *ppszTranslatedURL
);

Parameter

pcszURL

Typ: PCTSTR-

Die Adresse der zu übersetzenden URL-Zeichenfolge.

dwInFlags

Typ: DWORD-

Die Bitkennzeichnungen, die angeben, wie die URL-Zeichenfolge übersetzt werden soll. Dieser Wert kann eine Kombination aus folgendem Sein:

TRANSLATEURL_FL_GUESS_PROTOCOL

Wenn das Protokollschema im pcszURL- Parameter zum TranslateURL-nicht angegeben ist, wählt das System automatisch ein Schema aus und fügt es der URL hinzu.

TRANSLATEURL_FL_USE_DEFAULT_PROTOCOL

Wenn das Protokollschema nicht im pcszURL Parameter zum TranslateURL-angegeben ist, fügt das System das Standardprotokoll zur URL hinzu.

[out] ppszTranslatedURL

Typ: PTSTR*

Eine Zeigervariable, die den Zeiger auf die neu erstellte, übersetzte URL-Zeichenfolge empfängt, falls vorhanden. Der ppszTranslatedURL- Parameter ist nur gültig, wenn die Funktion S_OK zurückgibt.

Rückgabewert

Typ: HRESULT-

Gibt S_OK nach Erfolg oder S_FALSE zurück, wenn die URL keine Übersetzung erforderte. Wenn ein Fehler auftritt, gibt die Funktion einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
E_FLAGS	Die in dwInFlags übergebene Kennzeichenkombination ist ungültig.
E_OUTOFMEMORY	Zum Abschließen des Vorgangs war nicht genügend Arbeitsspeicher vorhanden.
E_POINTER	Einer der Eingabezeiger ist ungültig.

Bemerkungen

Diese Funktion überprüft die Eingabe-URL-Zeichenfolge nicht. Ein erfolgreicher Rückgabewert gibt nicht an, dass die URL-Zeichenfolgen gültige URLs sind.

Anmerkung

Der Header intshcut.h definiert TranslateURL als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	intshcut.h
DLL-	Url.dll