Partager via


WSDUriDecode, fonction (wsdutil.h)

Décode un URI en fonction des règles de RFC2396.

Syntaxe

HRESULT WSDUriDecode(
  [in]            LPCWSTR source,
  [in]            DWORD   cchSource,
  [out]           LPWSTR  *destOut,
  [out, optional] DWORD   *cchDestOut
);

Paramètres

[in] source

Contient l’URI à décoder.

[in] cchSource

Spécifie la longueur de la source en caractères.

[out] destOut

Pointeur vers une chaîne qui contient l’URI décodé. Si destOut n’est pas NULL, l’application appelante doit libérer la chaîne allouée en appelant WSDFreeLinkedMemory.

[out, optional] cchDestOut

Spécifie la longueur de destOut en caractères.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
La fonction s’est terminée avec succès.
E_INVALIDARG
source est NULL ou cchSource est égal à 0.
E_FAIL
La longueur en caractères de la source dépasse WSD_MAX_TEXT_LENGTH (8192).
E_POINTER
destOut a la valeur NULL.

Remarques

WSDUriDecode décode tous les caractères encodés dans la source. Ces caractères sont identifiés par un signe de pourcentage (%) suivi de deux chiffres hexadécimaux. WSDUriDecode décode les composants codés sur un octet de caractères multioctets et les convertit à nouveau en représentation de caractères larges dans destOut.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête wsdutil.h (inclure Wsdapi.h)
Bibliothèque Wsdapi.lib
DLL Wsdapi.dll