Fungsi HttpAddUrl (http.h)
Fungsi HttpAddUrl mendaftarkan URL tertentu sehingga permintaan yang cocok dirutekan ke antrean permintaan HTTP Server API tertentu. Aplikasi dapat mendaftarkan beberapa URL ke satu antrean permintaan menggunakan panggilan berulang ke HttpAddUrl. Untuk informasi selengkapnya tentang bagaimana HTTP Server API cocok dengan URL permintaan dengan URL terdaftar, lihat String UrlPrefix.
Dimulai dengan HTTP Server API Versi 2.0, aplikasi harus memanggil HttpAddUrlToUrlGroup untuk mendaftarkan URL; HttpAddUrl tidak boleh digunakan.
Sintaks
HTTPAPI_LINKAGE ULONG HttpAddUrl(
[in] HANDLE RequestQueueHandle,
[in] PCWSTR FullyQualifiedUrl,
PVOID Reserved
);
Parameter
[in] RequestQueueHandle
Handel ke antrean permintaan tempat permintaan URL yang ditentukan akan dirutekan. Antrean permintaan dibuat dan handelnya dikembalikan oleh panggilan ke fungsi HttpCreateRequestQueue .
Windows Server 2003 dengan SP1 dan Windows XP dengan SP2: Handel ke antrean permintaan dibuat oleh fungsi HttpCreateHttpHandle .
[in] FullyQualifiedUrl
Penunjuk ke string Unicode yang berisi string UrlPrefix yang dibentuk dengan benar yang mengidentifikasi URL yang akan didaftarkan.
Reserved
Dipesan; harus NULL.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan adalah NO_ERROR.
Jika fungsi gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut.
Nilai | Makna |
---|---|
|
Aplikasi panggilan tidak memiliki izin untuk mendaftarkan URL. |
|
Aplikasi panggilan tidak memanggil HttpInitialize sebelum memanggil fungsi ini. |
|
Salah satu parameter tidak valid. |
|
UrlPrefix yang ditentukan berkonflik dengan pendaftaran yang ada. |
|
Sumber daya tidak cukup untuk menyelesaikan operasi. |
|
Kode kesalahan sistem yang ditentukan dalam WinError.h. |
Keterangan
Seperti yang dinyatakan dalam topik UrlPrefix Strings , spesifikasi skema UrlPrefix yang akan didaftarkan harus berupa huruf kecil "http" atau huruf kecil "https". Tidak ada substring lain yang valid.
Selain itu, tidak dimungkinkan untuk mendaftarkan URL yang memiliki skema yang berbeda pada port yang sama. Artinya, skema "http" dan "https" tidak dapat hidup berdampingan pada port.
Perlu diketahui juga bahwa HttpAddUrl mendaftarkan UrlPrefix apa pun yang diteruskan ke sana selama string terbentuk dengan baik. Validasi keberadaan, aksesibilitas, kepemilikan, atau karakteristik lain dari namespace URL yang ditentukan harus ditangani oleh aplikasi.
Untuk merilis sumber daya yang dialokasikan sebagai hasil dari pendaftaran yang dilakukan oleh HttpAddUrl, lakukan panggilan yang cocok ke fungsi HttpRemoveUrl ketika aplikasi Anda telah selesai dengan namespace yang terlibat.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista, Windows XP dengan SP2 [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | http.h |
Pustaka | Httpapi.lib |
DLL | Httpapi.dll |