Compartir a través de

Función WsCombineUrl (webservices.h)

  • Artículo

Genera una dirección URL absoluta a partir de una referencia url especificada (dirección URL absoluta o relativa) y una dirección URL base absoluta especificada.

Sintaxis

HRESULT WsCombineUrl(
  [in]           const WS_STRING *baseUrl,
  [in]           const WS_STRING *referenceUrl,
  [in]           ULONG           flags,
  [in]           WS_HEAP         *heap,
  [out]          WS_STRING       *resultUrl,
  [in, optional] WS_ERROR        *error
);

Parámetros

[in] baseUrl

Puntero a una estructura de WS_STRING que contiene una dirección URL absoluta en formato codificado.

[in] referenceUrl

Puntero a una estructura de WS_STRING que contiene una dirección URL absoluta o relativa en formato codificado.

[in] flags

Controla el formato de la dirección URL resultante. Para obtener más información, consulte WS_URL_FLAGS.

[in] heap

Puntero al objeto WS_HEAP desde el que se asigna la memoria de la dirección URL resultante.

[out] resultUrl

Puntero a una estructura de WS_STRING que recibe la dirección URL resultante. Se trata de una dirección URL absoluta en formato codificado.

[in, optional] error

Puntero a una estructura de WS_ERROR que recibe información de error adicional si se produce un error en la función.

Valor devuelto

Si la función se realiza correctamente, devuelve NO_ERROR; de lo contrario, devuelve un código de error HRESULT.

Código devuelto Descripción
E_INVALIDARG
 Uno o varios argumentos no son válidos.
E_OUTOFMEMORY
 Memoria insuficiente para completar la operación.
WS_E_INVALID_FORMAT
 La dirección URL base o la dirección URL de referencia no tenían el formato correcto o tenían un esquema que no se reconocía.
Otros errores
Esta función puede devolver otros errores no enumerados anteriormente.

Comentarios

Si la dirección URL de referencia es absoluta, se devuelve sin cambios, si las marcas especificadas permiten. Si la dirección URL de referencia es relativa, se combina con la dirección URL base antes de que se devuelva.

Solo se admiten los esquemas enumerados en WS_URL_SCHEME_TYPE .

Requisitos

   
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado webservices.h
Library WebServices.lib
Archivo DLL WebServices.dll