Fungsi WsCombineUrl (webservices.h)

Artikel
08/27/2023

Menghasilkan URL absolut dari referensi URL tertentu (URL absolut atau relatif) dan URL dasar absolut tertentu.

Sintaks

HRESULT WsCombineUrl(
  [in]           const WS_STRING *baseUrl,
  [in]           const WS_STRING *referenceUrl,
  [in]           ULONG           flags,
  [in]           WS_HEAP         *heap,
  [out]          WS_STRING       *resultUrl,
  [in, optional] WS_ERROR        *error
);

Parameter

[in] baseUrl

Penunjuk ke struktur WS_STRING yang berisi URL absolut dalam format yang dikodekan.

[in] referenceUrl

Penunjuk ke struktur WS_STRING yang berisi URL absolut atau relatif dalam format yang dikodekan.

[in] flags

Mengontrol format URL yang dihasilkan. Untuk informasi selengkapnya, lihat WS_URL_FLAGS.

[in] heap

Arahkan ke objek WS_HEAP tempat memori untuk URL yang dihasilkan dialokasikan.

[out] resultUrl

Arahkan ke struktur WS_STRING yang menerima URL yang dihasilkan. Ini adalah URL absolut dalam format yang dikodekan.

[in, optional] error

Penunjuk ke struktur WS_ERROR yang menerima informasi kesalahan tambahan jika fungsi gagal.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan NO_ERROR; jika tidak, kode kesalahan HRESULT akan dikembalikan.

Menampilkan kode	Deskripsi
E_INVALIDARG	Satu atau beberapa argumen tidak valid.
E_OUTOFMEMORY	Tidak cukup memori untuk menyelesaikan operasi.
WS_E_INVALID_FORMAT	URL dasar atau URL referensi tidak dalam format yang benar, atau memiliki skema yang tidak dikenali.
Kesalahan Lainnya	Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas.

Keterangan

Jika URL referensi bersifat absolut, URL tersebut dikembalikan tidak berubah, jika bendera yang ditentukan mengizinkan. Jika URL referensi relatif, URL tersebut digabungkan dengan URL dasar sebelum dikembalikan.

Hanya skema yang tercantum di WS_URL_SCHEME_TYPE yang didukung.

Persyaratan


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

Bagikan melalui