Fungsi WsEncodeUrl (webservices.h)
Mengodekan WS_URL yang ditentukan ke dalam string URL mengingat bagian komponennya. Nilai diloloskan seperlunya, digabungkan, dan disimpan dalam WS_HEAP yang ditentukan, dan hasilnya dikembalikan sebagai WS_STRING.
Sintaks
HRESULT WsEncodeUrl(
[in] const WS_URL *url,
[in] ULONG flags,
[in] WS_HEAP *heap,
[out] WS_STRING *outUrl,
[in, optional] WS_ERROR *error
);
Parameter
[in] url
Referensi ke WS_URL untuk dikodekan.
[in] flags
Nilai parameter ini menentukan metode evaluasi skema URL. Lihat WS_URL_FLAGS.
[in] heap
Penunjuk ke WS_HEAP untuk mengalokasikan URL.
[out] outUrl
Penunjuk ke string URL yang dihasilkan.
[in, optional] error
Penunjuk ke objek WS_ERROR tempat informasi tambahan tentang kesalahan harus disimpan jika fungsi gagal.
Mengembalikan nilai
Fungsi ini dapat mengembalikan salah satu nilai ini.
Menampilkan kode | Deskripsi |
---|---|
|
Satu atau beberapa argumen tidak valid. |
|
Kehabisan memori. |
|
Data URL yang dikodekan tidak valid sesuai dengan sintaks URL. |
|
Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas. |
Keterangan
Jika skema tidak dikenali dalam parameter url , fungsi mengembalikan WS_E_INVALID_FORMAT.
Hanya jenis skema yang diidentifikasi di WS_URL_SCHEME_TYPE yang didukung.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 7 [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP] |
Target Platform | Windows |
Header | webservices.h |
Pustaka | WebServices.lib |
DLL | WebServices.dll |