Fungsi WsEncodeUrl (webservices.h)

Artikel
03/13/2024

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
E_INVALIDARG	Satu atau beberapa argumen tidak valid.
E_OUTOFMEMORY	Kehabisan memori.
WS_E_INVALID_FORMAT	Data URL yang dikodekan tidak valid sesuai dengan sintaks URL.
Kesalahan Lain	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

Share via