Función WsCombineUrl (webservices.h)

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.

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