WsDecodeUrl, fonction (webservices.h)

Article
08/27/2023

É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.

Code de retour	Description
E_INVALIDARG	Un ou plusieurs arguments ne sont pas valides.
E_OUTOFMEMORY	Mémoire insuffisante.
WS_E_INVALID_FORMAT	L’URL d’entrée n’était pas au format correct ou le schéma n’a pas été reconnu.
Autres erreurs	Cette fonction peut retourner d’autres erreurs non répertoriées ci-dessus.

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

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	webservices.h
Bibliothèque	WebServices.lib
DLL	WebServices.dll

Partager via