WsCombineUrl, fonction (webservices.h)

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.

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