Compartir a través de

Función WsDecodeUrl (webservices.h)

  • Artículo

Evalúa los componentes de una dirección URL para determinar su "esquema". Un valor WS_URL_SCHEME_TYPE se encapsula en una estructura de WS_URL y se devuelve una referencia a la estructura a través del parámetro de salida. Si no se reconoce el esquema, la función devuelve WS_E_INVALID_FORMAT.
Solo se admiten los tipos de esquema identificados en WS_URL_SCHEME_TYPE .

Sintaxis

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

Parámetros

[in] url

Puntero a una representación WS_STRING de la dirección URL que se va a evaluar.

[in] flags

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 referencia de dirección URL devuelta.

outUrl

Referencia a la estructura de WS_URL que encapsula el valor de WS_URL_SCHEME_TYPE .

[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
 La dirección URL de entrada no estaba en el formato correcto o no se reconoció el esquema.
Otros errores
Esta función puede devolver otros errores no enumerados anteriormente.

Comentarios

La gramática analizada para los esquemas "http", "https", "net.tcp" y "soap.udp" se puede encontrar en http://www.ietf.org/rfc/rfc3986.txt. Para estos esquemas:

  • Se requiere un nombre de host no vacío.
  • Para la producción del literal IP, se devuelven todos los caracteres delimitados por "[" y "]". No se aplican para seguir la producción de IPv6Address.
  • No se admite la parte userinfo de la autoridad (por ejemplo, userinfo@hostname:port).

Si no se especifica ningún puerto, se devuelve el puerto predeterminado para ese esquema.

Si no se especifica ningún puerto para el esquema soap.udp 0xFFFFFFFF se devuelve como valor predeterminado.

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