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 |
---|---|
|
La funzione è stata completata correttamente. |
|
source è NULL o cchSource è 0. |
|
La lunghezza in caratteri di origine supera WSD_MAX_TEXT_LENGTH (8192). |
|
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 |