UrlUnescapeW-Funktion (shlwapi.h)

Artikel
11/20/2024

Konvertiert Escapesequenzen wieder in normale Zeichen.

Syntax

LWSTDAPI UrlUnescapeW(
  [in, out]           PWSTR pszUrl,
  [out, optional]     PWSTR pszUnescaped,
  [in, out, optional] DWORD *pcchUnescaped,
                      DWORD dwFlags
);

Parameter

[in, out] pszUrl

Typ: PTSTR-

Ein Zeiger auf eine mit Null beendete Zeichenfolge mit der URL. Wenn dwFlags- auf URL_UNESCAPE_INPLACEfestgelegt ist, wird die konvertierte Zeichenfolge über diesen Parameter zurückgegeben.

[out, optional] pszUnescaped

Typ: PTSTR-

Ein Zeiger auf einen Puffer, der eine mit Null beendete Zeichenfolge empfängt, die die nicht dargestellte Version von pszURL-enthält. Wenn URL_UNESCAPE_INPLACE in dwFlags-festgelegt ist, wird dieser Parameter ignoriert.

[in, out, optional] pcchUnescaped

Typ: DWORD*-

Die Anzahl der Zeichen im Puffer, auf die pszUnescapedverweist. Bei der Eingabe wird der Wert pcchUnescaped Punkt auf die Größe des Puffers festgelegt. Wenn die Funktion einen Erfolgscode zurückgibt und das URL_UNESCAPE_INPLACE Flag nicht festgelegt ist, wird der Wert, auf den pcchUnescaped verweist, auf die Anzahl der Zeichen festgelegt, die in diesen Puffer geschrieben wurden, und nicht auf das endende NULL Zeichen. Wenn ein E_POINTER Fehlercode zurückgegeben wird, war der Puffer zu klein, und der Wert, auf den pcchUnescaped Punkte festgelegt ist, wird auf die erforderliche Anzahl von Zeichen festgelegt, die der Puffer enthalten muss. Wenn andere Fehler zurückgegeben werden, ist der Wert, an den pcchUnescaped Punkte nicht definiert ist.

dwFlags

Typ: DWORD-

Flags, die steuern, welche Zeichen nicht dargestellt werden. Dies kann eine Kombination aus den folgenden Flags sein.

URL_DONT_UNESCAPE_EXTRA_INFO

Konvertieren Sie das #- oder ? Zeichen oder beliebige Zeichen, die sie in der Zeichenfolge folgen.

URL_UNESCAPE_AS_UTF8

in Windows 8eingeführt. Decodieren Sie URLs, die mithilfe des URL_ESCAPE_AS_UTF8-Flags codiert wurden.

URL_UNESCAPE_INPLACE

Verwenden Sie pszURL-, um die konvertierte Zeichenfolge anstelle von pszUnescaped-zurückzugeben.

Rückgabewert

Typ: HRESULT-

Gibt S_OK zurück, wenn dies erfolgreich ist. Wenn das URL_UNESCAPE_INPLACE Flag nicht festgelegt ist, wird der wert, auf den pcchUnescaped verweist, auf die Anzahl der Zeichen im Ausgabepuffer festgelegt, auf die pszUnescapedverweist. Gibt E_POINTER zurück, wenn das flag URL_UNESCAPE_INPLACE nicht festgelegt ist und der Ausgabepuffer zu klein ist. Der pcchUnescaped Parameter wird auf die erforderliche Puffergröße festgelegt. Andernfalls wird ein Standardfehlerwert zurückgegeben.

Bemerkungen

Eine Escapesequenz hat die Form "%xy".

Eingabezeichenfolgen dürfen nicht länger als INTERNET_MAX_URL_LENGTH sein.

Anmerkung

Der Header "shlwapi.h" definiert UrlUnescape 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 2000 Professional, Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shlwapi.h
Library	Shlwapi.lib
DLL-	Shlwapi.dll (Version 5.0 oder höher)

Freigeben über