WsCombineUrl, fonction (webservices.h)

Article
08/27/2023

Produit une URL absolue à partir d’une référence d’URL spécifiée (URL absolue ou relative) et d’une URL de base absolue spécifiée.

Syntaxe

HRESULT WsCombineUrl(
  [in]           const WS_STRING *baseUrl,
  [in]           const WS_STRING *referenceUrl,
  [in]           ULONG           flags,
  [in]           WS_HEAP         *heap,
  [out]          WS_STRING       *resultUrl,
  [in, optional] WS_ERROR        *error
);

Paramètres

[in] baseUrl

Pointeur vers une structure WS_STRING contenant une URL absolue au format codé.

[in] referenceUrl

Pointeur vers une structure WS_STRING contenant une URL absolue ou relative au format encodé.

[in] flags

Contrôle le format de l’URL résultante. Pour plus d’informations, consultez WS_URL_FLAGS.

[in] heap

Pointeur vers l’objet WS_HEAP à partir duquel la mémoire de l’URL résultante est allouée.

[out] resultUrl

Pointeur vers une structure WS_STRING qui reçoit l’URL résultante. Il s’agit d’une URL absolue au format encodé.

[in, optional] error

Pointeur vers une structure de WS_ERROR qui reçoit des informations d’erreur supplémentaires en cas d’échec de la fonction.

Valeur retournée

Si la fonction réussit, elle retourne NO_ERROR ; sinon, il retourne un code d’erreur HRESULT.

Code de retour	Description
E_INVALIDARG	Un ou plusieurs arguments ne sont pas valides.
E_OUTOFMEMORY	Mémoire insuffisante pour terminer l’opération.
WS_E_INVALID_FORMAT	L’URL de base ou l’URL de référence n’était pas au format correct ou avait un schéma qui n’était pas reconnu.
Autres erreurs	Cette fonction peut renvoyer d’autres erreurs non répertoriées ci-dessus.

Remarques

Si l’URL de référence est absolue, elle est retournée inchangée, si les indicateurs spécifiés le permettent. Si l’URL de référence est relative, elle est combinée à l’URL de base avant d’être retournée.

Seuls les schémas répertoriés dans WS_URL_SCHEME_TYPE sont pris en charge.

Configuration requise


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