Fungsi WSDUriEncode (wsdutil.h)

Mengodekan URI sesuai dengan aturan pengodean URI dalam RFC2396.

Sintaks

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

Parameter

[in] source

Berisi URI yang akan dikodekan.

[in] cchSource

Menentukan panjang sumber dalam karakter.

[out] destOut

Penunjuk ke string yang berisi URI yang dikodekan. Jika destOut bukan NULL, aplikasi panggilan harus membebaskan string yang dialokasikan dengan memanggil WSDFreeLinkedMemory.

[out, optional] cchDestOut

Menentukan panjang destOut dalam karakter.

Mengembalikan nilai

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Fungsi berhasil diselesaikan.
E_INVALIDARG	sumbernya adalah NULL atau cchSource adalah 0.
E_FAIL	Panjang karakter sumber melebihi WSD_MAX_TEXT_LENGTH (8192).
E_POINTER	destOut adalah NULL.

Keterangan

WSDUriEncode mengodekan karakter tertentu dalam sumber ke dalam format pengodean %XY yang lolos, di mana X dan Y adalah digit heksadesimal yang sesuai dengan representasi byte tunggal dari karakter tersebut. Karakter lebar yang menempati beberapa byte pertama kali dirender ke dalam format multi-byte UTF-8, lalu diloloskan ke dalam karakter yang dikodekan.

WSDUriEncode tidak mengodekan karakter alfanumerik byte tunggal. Ini mengodekan tanda persen (%) di sumber.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	wsdutil.h (termasuk Wsdapi.h)
Pustaka	Wsdapi.lib
DLL	Wsdapi.dll