Compartir a través de

Función WsEncodeUrl (webservices.h)

  • Artículo

Codifica el WS_URL especificado en una cadena de dirección URL dadas sus partes de componente. Los valores se escapan según sea necesario, combinado y se almacenan en el WS_HEAP especificado y el resultado se devuelve como un WS_STRING.

Sintaxis

HRESULT WsEncodeUrl(
  [in]           const WS_URL *url,
  [in]           ULONG        flags,
  [in]           WS_HEAP      *heap,
  [out]          WS_STRING    *outUrl,
  [in, optional] WS_ERROR     *error
);

Parámetros

[in] url

Referencia al WS_URL que se va a codificar.

[in] flags

El valor de este parámetro determina el método de evaluación del esquema de dirección URL. Consulte WS_URL_FLAGS.

[in] heap

Puntero a un WS_HEAP en el que se va a asignar la dirección URL.

[out] outUrl

Puntero a la cadena de dirección URL resultante.

[in, optional] error

Puntero a un objeto WS_ERROR donde se debe almacenar información adicional sobre el error si se produce un error en la función.

Valor devuelto

Esta función puede devolver uno de estos valores.

Código devuelto Descripción
E_INVALIDARG
 Uno o más argumentos no son válidos.
E_OUTOFMEMORY
 Se quedó sin memoria.
WS_E_INVALID_FORMAT
 Los datos de dirección URL que se codifican no eran válidos según la sintaxis de la dirección URL.
Otros errores
Esta función puede devolver otros errores no enumerados anteriormente.

Comentarios

Si no se reconoce un esquema en el parámetro url , la función devuelve WS_E_INVALID_FORMAT.
Solo se admiten los tipos de esquema identificados en WS_URL_SCHEME_TYPE .

Requisitos

Requisito Value
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