Función UrlUnescapeA (shlwapi.h)

Artículo
11/20/2024

Convierte las secuencias de escape en caracteres normales.

Sintaxis

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

Parámetros

[in, out] pszUrl

Tipo: PTSTR de

Puntero a una cadena terminada en null con la dirección URL. Si dwFlags se establece en URL_UNESCAPE_INPLACE, la cadena convertida se devuelve a través de este parámetro.

[out, optional] pszUnescaped

Tipo: PTSTR de

Puntero a un búfer que recibirá una cadena terminada en NULL que contiene la versión nocaped de pszURL. Si URL_UNESCAPE_INPLACE se establece en dwFlags, este parámetro se omite.

[in, out, optional] pcchUnescaped

Tipo: DWORD* de

Número de caracteres del búfer al que apunta pszUnescaped. En la entrada, el valor pcchUnescaped apunta a se establece en el tamaño del búfer. Si la función devuelve un código correcto y no se establece la marca de URL_UNESCAPE_INPLACE, el valor que pcchUnescaped apunta a se establece en el número de caracteres escritos en ese búfer, sin contar el carácter de de terminación NULL. Si se devuelve un código de error E_POINTER, el búfer era demasiado pequeño y el valor al que pcchUnescaped puntos se establece en el número necesario de caracteres que debe contener el búfer. Si se devuelven otros errores, el valor al que puntos de pcchUnescaped no está definido.

dwFlags

Tipo: DWORD de

Marca que controla qué caracteres están sin escape. Puede ser una combinación de las marcas siguientes.

URL_DONT_UNESCAPE_EXTRA_INFO

No convierta el número o ? carácter o cualquier carácter que los siga en la cadena.

URL_UNESCAPE_AS_UTF8

introducido en Windows 8. Descodifique las direcciones URL que se codificaron mediante la marca URL_ESCAPE_AS_UTF8.

URL_UNESCAPE_INPLACE

Use pszURL para devolver la cadena convertida en lugar de pszUnescaped.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente. Si no se establece la marca de URL_UNESCAPE_INPLACE, el valor al que apunta pcchUnescaped se establecerá en el número de caracteres del búfer de salida al que apunta pszUnescaped. Devuelve E_POINTER si no se establece la marca URL_UNESCAPE_INPLACE y el búfer de salida es demasiado pequeño. El parámetro pcchUnescaped se establecerá en el tamaño de búfer necesario. De lo contrario, devuelve un valor de error estándar.

Observaciones

Una secuencia de escape tiene la forma "%xy".

Las cadenas de entrada no pueden ser más largas que INTERNET_MAX_URL_LENGTH.

Nota

El encabezado shlwapi.h define UrlUnescape como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	shlwapi.h
biblioteca de	Shlwapi.lib
DLL de	Shlwapi.dll (versión 5.0 o posterior)

Compartir a través de