WsDecodeUrl, fonction (webservices.h)

Évalue les composants d’une URL pour déterminer son « schéma ». Une valeur WS_URL_SCHEME_TYPE est encapsulée dans une structure WS_URL et une référence à la structure est retournée via le paramètre de sortie. Si le schéma n’est pas reconnu, la fonction retourne WS_E_INVALID_FORMAT.
Seuls les types de schémas identifiés dans WS_URL_SCHEME_TYPE sont pris en charge.

Syntaxe

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

Paramètres

[in] url

Pointeur vers une représentation WS_STRING de l’URL à évaluer.

[in] flags

Détermine la méthode d’évaluation du schéma d’URL. Voir WS_URL_FLAGS.

[in] heap

Pointeur vers un WS_HEAP dans lequel allouer la référence d’URL retournée.

outUrl

Référence à la structure WS_URL qui encapsule la valeur WS_URL_SCHEME_TYPE .

[in, optional] error

Pointeur vers un objet WS_ERROR où des informations supplémentaires sur l’erreur doivent être stockées en cas d’échec de la fonction.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Remarques

La grammaire analysée pour les schémas « http », « https », « net.tcp » et « soap.udp » se trouve à l’adresse http://www.ietf.org/rfc/rfc3986.txt. Pour ces schémas :

• Un nom d’hôte non vide est requis.
• Pour la production de littéraux IP, tous les caractères délimités par « [ » et « ] » sont retournés. Elles ne sont pas appliquées pour suivre la production IPv6Address.
• La partie userinfo de l’autorité (par exemple, userinfo@hostname :port) n’est pas prise en charge.

Si aucun port n’est spécifié, le port par défaut de ce schéma est retourné.

Si aucun port n’est spécifié pour le schéma soap.udp 0xFFFFFFFF est retourné comme port par défaut.

Configuration requise