UrlUnescapeA-Funktion (shlwapi.h)
Konvertiert Escapesequenzen wieder in normale Zeichen.
Syntax
LWSTDAPI UrlUnescapeA(
[in, out] PSTR pszUrl,
[out, optional] PSTR pszUnescaped,
[in, out, optional] DWORD *pcchUnescaped,
DWORD dwFlags
);
Parameter
[in, out] pszUrl
Typ: PTSTR
Ein Zeiger auf eine NULL-Zeichenfolge mit der URL. Wenn dwFlags auf URL_UNESCAPE_INPLACE festgelegt ist, wird die konvertierte Zeichenfolge über diesen Parameter zurückgegeben.
[out, optional] pszUnescaped
Typ: PTSTR
Ein Zeiger auf einen Puffer, der eine null-beendete Zeichenfolge empfängt, die die nicht gescapete 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 von pszUnescaped verwiesen wird. Beim Eintrag wird der Wert pcchUnescaped auf 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, wobei das beendende NULL-Zeichen nicht gezählt wird. Wenn ein E_POINTER Fehlercode zurückgegeben wird, war der Puffer zu klein, und der Wert, auf den pcchUnescaped points festgelegt ist, ist auf die erforderliche Anzahl von Zeichen festgelegt, die der Puffer enthalten können muss. Wenn andere Fehler zurückgegeben werden, ist der Wert, für den pcchUnescaped points nicht definiert ist.
dwFlags
Art: DWORD
Flags, die steuern, welche Zeichen nicht gescapet werden. Dies kann eine Kombination der folgenden Flags sein.
URL_DONT_UNESCAPE_EXTRA_INFO
Konvertieren Sie nicht das # oder ? oder beliebige Zeichen, die ihnen in der Zeichenfolge folgen.
URL_UNESCAPE_AS_UTF8
In Windows 8 eingeführt. Decodieren Sie URLs, die mithilfe des flags URL_ESCAPE_AS_UTF8 codiert wurden.
URL_UNESCAPE_INPLACE
Verwenden Sie pszURL , um die konvertierte Zeichenfolge anstelle von pszUnescaped zurückzugeben.
Rückgabewert
Typ: HRESULT
Gibt bei erfolgreicher Ausführung S_OK zurück. Wenn das URL_UNESCAPE_INPLACE-Flag nicht festgelegt ist, wird der Wert, auf den von pcchUnescaped verwiesen wird, auf die Anzahl der Zeichen im Ausgabepuffer festgelegt, auf die von pszUnescaped verwiesen wird. Gibt E_POINTER zurück, wenn das URL_UNESCAPE_INPLACE-Flag nicht festgelegt ist und der Ausgabepuffer zu klein ist. Der parameter pcchUnescaped wird auf die erforderliche Puffergröße festgelegt. Andernfalls wird ein Standardfehlerwert zurückgegeben.
Hinweise
Eine Escapesequenz hat das Format "%xy".
Eingabezeichenfolgen dürfen nicht länger als INTERNET_MAX_URL_LENGTH sein.
Hinweis
Der shlwapi.h-Header definiert UrlUnescape als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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 2000 Professional, Windows XP [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | shlwapi.h |
Bibliothek | Shlwapi.lib |
DLL | Shlwapi.dll (Version 5.0 oder höher) |
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für