Compartir a través de

Función InternetCombineUrlA (wininet.h)

  • Artículo

Combina una dirección URL base y relativa en una sola dirección URL. La dirección URL resultante está canónica (consulte InternetCanonicalizeUrl).

Sintaxis

BOOL InternetCombineUrlA(
  [in]      LPCSTR  lpszBaseUrl,
  [in]      LPCSTR  lpszRelativeUrl,
  [out]     LPSTR   lpszBuffer,
  [in, out] LPDWORD lpdwBufferLength,
  [in]      DWORD   dwFlags
);

Parámetros

[in] lpszBaseUrl

Puntero a una cadena terminada en null que contiene la dirección URL base.

[in] lpszRelativeUrl

Puntero a una cadena terminada en null que contiene la dirección URL relativa.

[out] lpszBuffer

Puntero a un búfer que recibe la dirección URL combinada.

[in, out] lpdwBufferLength

Puntero a una variable que contiene el tamaño del búfer de lpszBuffer, en caracteres. Si la función se ejecuta correctamente, este parámetro recibe el tamaño de la dirección URL combinada, en caracteres, sin incluir el carácter de terminación null. Si se produce un error en la función, este parámetro recibe el tamaño del búfer necesario, en caracteres (incluido el carácter de terminación null).

[in] dwFlags

Controla el funcionamiento de la función. Este parámetro puede ser uno de los siguientes valores.

Valor Significado
ICU_BROWSER_MODE
 No codifica ni descodifica caracteres después de "#" o "?", y no quita el espacio en blanco final después de "?". Si no se especifica este valor, se codifica toda la dirección URL y se quita el espacio en blanco final.
ICU_DECODE
 Convierte todas las secuencias de %XX en caracteres, incluidas las secuencias de escape, antes de analizar la dirección URL.
ICU_ENCODE_PERCENT
 Codifica los signos de porcentaje encontrados. De forma predeterminada, los signos de porcentaje no están codificados. Este valor está disponible en Microsoft Internet Explorer 5 y versiones posteriores.
ICU_ENCODE_SPACES_ONLY
 Codifica solo los espacios.
ICU_NO_ENCODE
 No convierte caracteres no seguros en secuencias de escape.
ICU_NO_META
 No quita las secuencias meta (como "." y "..") de la dirección URL.

Valor devuelto

Devuelve TRUE si se ejecuta correctamente o FALSE de lo contrario. Para obtener información de error extendida, llame a GetLastError. Entre los posibles errores se incluyen los siguientes.

Código devuelto Descripción
ERROR_BAD_PATHNAME
 No se pudieron combinar las direcciones URL.
ERROR_INSUFFICIENT_BUFFER
 El búfer proporcionado a la función no era suficiente o NULL. El valor indicado por el parámetro lpdwBufferLength contendrá el número de bytes necesarios para contener la dirección URL combinada.
ERROR_INTERNET_INVALID_URL
 El formato de la dirección URL no es válido.
ERROR_INVALID_PARAMETER
 Hay un parámetro de cadena, búfer, tamaño de búfer o marcas no válidos.

Observaciones

Nota WinINet no admite implementaciones de servidor. Además, no se debe usar desde un servicio. En el caso de las implementaciones de servidor o los servicios, use Servicios HTTP de Microsoft Windows (WinHTTP).
 

Nota

El encabezado wininet.h define InternetCombineUrl 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 [solo aplicaciones de escritorio]
servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de wininet.h
biblioteca de Wininet.lib
DLL de Wininet.dll

Consulte también

control de localizadores uniformes de recursos

funciones winINet