Condividi tramite


Funzione WSDUriEncode (wsdutil.h)

Codifica un URI in base alle regole di codifica URI in RFC2396.

Sintassi

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

Parametri

[in] source

Contiene l'URI da codificare.

[in] cchSource

Specifica la lunghezza dell'origine in caratteri.

[out] destOut

Puntatore a una stringa contenente l'URI codificato. 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

WSDUriEncode codifica determinati caratteri nell'origine in un formato di codifica di escape %XY, dove X e Y sono cifre esadecimali corrispondenti alla rappresentazione a byte singolo di tale carattere. I caratteri wide che occupano più byte vengono prima sottoposti a rendering in formato multibyte UTF-8 e quindi preceduti da un carattere di escape in caratteri codificati.

WSDUriEncode non codifica caratteri alfanumerici a byte singolo. Codifica i segni di percentuale (%) nell'origine.

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