TranslateURLA-Funktion (intshcut.h)

  • Artikel

Wendet allgemeine Übersetzungen auf eine angegebene 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

Art: DWORD

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

TRANSLATEURL_FL_GUESS_PROTOCOL

Wenn das Protokollschema nicht im pcszURL-Parameter für TranslateURL 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 für TranslateURL angegeben ist, fügt das System der URL das Standardprotokoll hinzu.

[out] ppszTranslatedURL

Typ: PTSTR*

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

Rückgabewert

Typ: HRESULT

Gibt bei Erfolg S_OK zurück oder S_FALSE, 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 Flagkombination ist ungültig.
E_OUTOFMEMORY
 Es war nicht genügend Arbeitsspeicher vorhanden, um den Vorgang abzuschließen.
E_POINTER
 Einer der Eingabezeiger ist ungültig.

Hinweise

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

Hinweis

Der Intshcut.h-Header 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
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile intshcut.h
DLL Url.dll