Fungsi InternetCombineUrlA (wininet.h)

  • Artikel

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

Sintaks

BOOL InternetCombineUrlA(
  [in]      LPCSTR  lpszBaseUrl,
  [in]      LPCSTR  lpszRelativeUrl,
  [out]     LPSTR   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

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

[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 putih berikutnya setelah "?". Jika nilai ini tidak ditentukan, seluruh URL dikodekan dan spasi putih 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

Persyaratan Nilai
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