Fungsi InternetCreateUrlA (wininet.h)

Artikel
03/04/2024

Membuat URL dari bagian komponennya.

Sintaks

BOOL InternetCreateUrlA(
  [in]      LPURL_COMPONENTSA lpUrlComponents,
  [in]      DWORD             dwFlags,
  [out]     LPSTR             lpszUrl,
  [in, out] LPDWORD           lpdwUrlLength
);

Parameter

[in] lpUrlComponents

Arahkan ke struktur URL_COMPONENTS yang berisi komponen untuk membuat URL.

[in] dwFlags

Mengontrol operasi fungsi ini. Parameter ini bisa menjadi satu atau beberapa nilai berikut.

Nilai	Makna
ICU_ESCAPE	Mengonversi semua karakter yang tidak aman ke urutan escape yang sesuai dalam string jalur yang ditunjukkan oleh anggota lpszUrlPath dan di lpszExtraInfo string informasi tambahan yang ditunjukkan oleh anggota struktur URL_COMPONENTS yang ditunjukkan oleh parameter lpUrlComponents . Versi Unicode internetCreateUrl akan terlebih dahulu mencoba mengonversi menggunakan halaman kode sistem. Jika gagal, maka akan kembali ke UTF-8.
ICU_USERNAME	Usang — diabaikan.

Nilai

Makna

ICU_ESCAPE

Mengonversi semua karakter yang tidak aman ke urutan escape yang sesuai dalam string jalur yang ditunjukkan oleh anggota lpszUrlPath dan di lpszExtraInfo string informasi tambahan yang ditunjukkan oleh anggota struktur URL_COMPONENTS yang ditunjukkan oleh parameter lpUrlComponents .

Versi Unicode internetCreateUrl akan terlebih dahulu mencoba mengonversi menggunakan halaman kode sistem. Jika gagal, maka akan kembali ke UTF-8.

ICU_USERNAME

Usang — diabaikan.

[out] lpszUrl

Penunjuk ke buffer yang menerima URL.

[in, out] lpdwUrlLength

Penunjuk ke variabel yang menentukan ukuran buffer URL lpszUrl , dalam TCHAR. Ketika fungsi kembali, parameter ini menerima ukuran string URL, tidak termasuk terminator NULL. Jika GetLastError mengembalikan ERROR_INSUFFICIENT_BUFFER, parameter ini menerima jumlah byte yang diperlukan untuk menahan URL yang dibuat.

Mengembalikan nilai

Mengembalikan TRUE jika fungsi berhasil, atau FALSE jika tidak. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Saat menentukan skema dalam struktur URL_COMPONENTS diteruskan ke lpUrlComponents, jika lpszScheme bukan NULL, skema tersebut akan digunakan untuk skema. Jika lpszScheme adalah NULL, skema dapat ditentukan menggunakan enumerasi INTERNET_SCHEME dengan mengatur nScheme ke INTERNET_SCHEME atau INTERNET_SCHEME_DEFAULT yang diperlukan.

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 InternetCreateUrl 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

Bagikan melalui