Fungsi InternetCombineUrlW (wininet.h)

Artikel
08/27/2023

Menggabungkan URL dasar dan relatif ke dalam satu URL. URL yang dihasilkan dikanoniskan (lihat InternetCanonicalizeUrl).

Sintaks

BOOL InternetCombineUrlW(
  [in]      LPCWSTR lpszBaseUrl,
  [in]      LPCWSTR lpszRelativeUrl,
  [out]     LPWSTR  lpszBuffer,
  [in, out] LPDWORD lpdwBufferLength,
  [in]      DWORD   dwFlags
);

Parameter

[in] lpszBaseUrl

Penunjuk ke string yang dihentikan null yang berisi URL dasar.

[in] lpszRelativeUrl

Penunjuk ke string yang dihentikan null yang berisi URL relatif.

[out] lpszBuffer

Penunjuk ke buffer yang menerima URL gabungan.

[in, out] lpdwBufferLength

Penunjuk ke variabel yang berisi ukuran buffer lpszBuffer , dalam karakter. Jika fungsi berhasil, parameter ini menerima ukuran URL gabungan, dalam karakter, tidak termasuk karakter yang mengakhiri null. Jika fungsi gagal, parameter ini menerima ukuran buffer yang diperlukan, dalam karakter (termasuk karakter yang mengakhiri null).

[in] dwFlags

Mengontrol pengoperasian fungsi. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
ICU_BROWSER_MODE	Tidak mengodekan atau mendekode karakter setelah "#" atau "?", dan tidak menghapus spasi kosong berikutnya setelah "?". Jika nilai ini tidak ditentukan, seluruh URL dikodekan dan spasi kosong berikutnya dihapus.
ICU_DECODE	Mengonversi semua urutan %XX ke karakter, termasuk urutan escape, sebelum URL diurai.
ICU_ENCODE_PERCENT	Mengodekan tanda persen yang ditemui. Secara default, tanda persen tidak dikodekan. Nilai ini tersedia di Microsoft Internet Explorer 5 dan yang lebih baru.
ICU_ENCODE_SPACES_ONLY	Mengodekan spasi saja.
ICU_NO_ENCODE	Tidak mengonversi karakter yang tidak aman untuk meloloskan urutan.
ICU_NO_META	Tidak menghapus urutan meta (seperti "." dan "..") dari URL.

Mengembalikan nilai

Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError. Kemungkinan kesalahan termasuk yang berikut ini.

Menampilkan kode	Deskripsi
ERROR_BAD_PATHNAME	URL tidak dapat digabungkan.
ERROR_INSUFFICIENT_BUFFER	Buffer yang diberikan ke fungsi tidak cukup atau NULL. Nilai yang ditunjukkan oleh parameter lpdwBufferLength akan berisi jumlah byte yang diperlukan untuk menahan URL gabungan.
ERROR_INTERNET_INVALID_URL	Format URL tidak valid.
ERROR_INVALID_PARAMETER	Ada parameter string, buffer, ukuran buffer, atau bendera yang tidak valid.

Keterangan

Catatan WinINet tidak mendukung implementasi server. Selain itu, itu tidak boleh digunakan dari layanan. Untuk implementasi atau layanan server, gunakan Microsoft Windows HTTP Services (WinHTTP).

Catatan

Header wininet.h mendefinisikan InternetCombineUrl sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	wininet.h
Pustaka	Wininet.lib
DLL	Wininet.dll

Lihat juga

Menangani Pencari Sumber Daya Seragam

Fungsi WinINet

Bagikan melalui