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
ERROR_ACCESS_DENIED	Aplikasi panggilan tidak memiliki izin untuk mendaftarkan URL.
ERROR_DLL_INIT_FAILED	Aplikasi panggilan tidak memanggil HttpInitialize sebelum memanggil fungsi ini.
ERROR_INVALID_PARAMETER	Salah satu parameter tidak valid.
ERROR_ALREADY_EXISTS	UrlPrefix yang ditentukan berkonflik dengan pendaftaran yang ada.
ERROR_NOT_ENOUGH_MEMORY	Sumber daya tidak cukup untuk menyelesaikan operasi.
Lainnya	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

Lihat juga

Fungsi HTTP Server API Versi 1.0

HttpAddUrlToUrlGroup

HttpRemoveUrl