Funzione WSDUriDecode (wsdutil.h)

Decodifica un URI in base alle regole in RFC2396.

Sintassi

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

Parametri

[in] source

Contiene l'URI da decodificare.

[in] cchSource

Specifica la lunghezza dell'origine in caratteri.

[out] destOut

Puntatore a una stringa contenente l'URI decodificato. Se destOut non è NULL, l'applicazione chiamante deve liberare la stringa allocata chiamando WSDFreeLinkedMemory.

[out, optional] cchDestOut

Specifica la lunghezza di destOut in caratteri.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	La funzione è stata completata correttamente.
E_INVALIDARG	source è NULL o cchSource è 0.
E_FAIL	La lunghezza in caratteri di origine supera WSD_MAX_TEXT_LENGTH (8192).
E_POINTER	destOut è NULL.

Commenti

WSDUriDecode decodifica tutti i caratteri codificati nell'origine. Questi caratteri sono identificati da un segno di percentuale (%) seguito da due cifre esadecimali. WSDUriDecode decodifica i componenti a byte singolo di caratteri a byte multiplo e li converte nuovamente in rappresentazione di caratteri wide in destOut.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wsdutil.h (include Wsdapi.h)
Libreria	Wsdapi.lib
DLL	Wsdapi.dll