WsEncodeUrl, fonction (webservices.h)

Article
03/03/2024

Encode le WS_URL spécifié dans une chaîne d’URL en fonction de ses composants. Les valeurs sont placées dans une séquence d’échappement en fonction des besoins, combinées et stockées dans le WS_HEAP spécifié, et le résultat est retourné en tant que WS_STRING.

Syntaxe

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

Paramètres

[in] url

Référence au WS_URL à encoder.

[in] flags

La valeur de ce paramètre 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 l’URL.

[out] outUrl

Pointeur vers la chaîne d’URL résultante.

[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	Les données d’URL encodées n’étaient pas valides selon la syntaxe d’URL.
Autres erreurs	Cette fonction peut retourner d’autres erreurs non répertoriées ci-dessus.

Remarques

Si un schéma n’est pas reconnu dans le paramètre URL , la fonction retourne WS_E_INVALID_FORMAT.
Seuls les types de schémas identifiés dans WS_URL_SCHEME_TYPE sont pris en charge.

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