Fungsi HttpAddUrlToUrlGroup (http.h)

Artikel
03/14/2023

Fungsi HttpAddUrlToUrlGroup menambahkan URL yang ditentukan ke Grup URL yang diidentifikasi oleh ID Grup URL.

Fungsi ini menggantikan fungsi HttpAddUrl http versi 1.0.

Sintaks

HTTPAPI_LINKAGE ULONG HttpAddUrlToUrlGroup(
  [in]           HTTP_URL_GROUP_ID UrlGroupId,
  [in]           PCWSTR            pFullyQualifiedUrl,
  [in, optional] HTTP_URL_CONTEXT  UrlContext,
  [in]           ULONG             Reserved
);

Parameter

[in] UrlGroupId

ID grup untuk grup URL tempat permintaan URL yang ditentukan dirutekan. Grup URL dibuat oleh fungsi HttpCreateUrlGroup .

[in] pFullyQualifiedUrl

Penunjuk ke string Unicode yang berisi String UrlPrefix yang dibentuk dengan benar yang mengidentifikasi URL yang akan didaftarkan. Jika Anda tidak berjalan sebagai administrator, tentukan nomor port yang lebih besar dari 1024, jika tidak, Anda mungkin mendapatkan kesalahan ERROR_ACCESS_DENIED.

[in, optional] UrlContext

Konteks yang terkait dengan URL yang terdaftar dalam panggilan ini. Konteks URL dikembalikan dalam struktur HTTP_REQUEST dengan setiap permintaan yang diterima pada URL yang ditentukan dalam parameter pFullyQualifiedUrl .

[in] Reserved

Dicadangkan. Harus nol.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan NO_ERROR

Jika fungsi gagal, fungsi mengembalikan salah satu kode kesalahan berikut.

Nilai	Makna
ERROR_INVALID_PARAMETER	UrlGroupId tidak ada. Parameter Yang Dipesan bukan nol. Aplikasi tidak memiliki izin untuk menambahkan URL ke Grup. Hanya aplikasi yang membuat Grup URL yang dapat menambahkan URL.
ERROR_ACCESS_DENIED	Proses panggilan tidak memiliki izin untuk mendaftarkan URL.
ERROR_ALREADY_EXISTS	URL yang ditentukan berkonflik dengan pendaftaran yang ada.

Nilai

Makna

ERROR_INVALID_PARAMETER

UrlGroupId tidak ada.

Parameter Yang Dipesan bukan nol.

Aplikasi tidak memiliki izin untuk menambahkan URL ke Grup. Hanya aplikasi yang membuat Grup URL yang dapat menambahkan URL.

ERROR_ACCESS_DENIED

Proses panggilan tidak memiliki izin untuk mendaftarkan URL.

ERROR_ALREADY_EXISTS

URL yang ditentukan berkonflik dengan pendaftaran yang ada.

Keterangan

HTTP Server API mendukung aplikasi yang ada menggunakan pendaftaran URL versi 1.0, namun, pengembangan baru dengan HTTP Server API harus menggunakan HttpAddUrlToUrlGroup; HttpAddUrl tidak boleh digunakan.

Aplikasi dapat menambahkan beberapa URL ke grup URL menggunakan panggilan berulang ke HttpAddUrlToUrlGroup. Permintaan yang cocok dengan URL yang ditentukan dirutekan ke antrean permintaan yang terkait dengan grup URL. Untuk informasi selengkapnya tentang bagaimana API Server HTTP cocok dengan URL permintaan ke URL terdaftar, lihat String UrlPrefix.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	http.h
Pustaka	Httpapi.lib
DLL	Httpapi.dll