Fungsi HttpSetServiceConfiguration (http.h)
Fungsi HttpSetServiceConfiguration membuat dan mengatur catatan konfigurasi untuk penyimpanan konfigurasi API Server HTTP. Panggilan gagal jika rekaman yang ditentukan sudah ada. Untuk mengubah rekaman konfigurasi tertentu, hapus lalu buat ulang dengan nilai yang berbeda.
Sintaks
HTTPAPI_LINKAGE ULONG HttpSetServiceConfiguration(
[in] HANDLE ServiceHandle,
[in] HTTP_SERVICE_CONFIG_ID ConfigId,
[in] PVOID pConfigInformation,
[in] ULONG ConfigInformationLength,
[in] LPOVERLAPPED pOverlapped
);
Parameter
[in] ServiceHandle
Dicadangkan. Harus nol.
[in] ConfigId
Jenis catatan konfigurasi yang akan diatur. Parameter ini dapat menjadi salah satu nilai berikut dari enumerasi HTTP_SERVICE_CONFIG_ID .
Nilai ConfigId | Makna |
---|---|
|
Mengatur catatan di Daftar Dengar IP. |
|
Mengatur catatan sertifikat SSL tertentu. |
|
Mengatur catatan reservasi URL. |
|
Mengatur batas waktu koneksi luas API Server HTTP yang ditentukan. Windows Vista dan yang lebih baru: Nilai enumerasi ini didukung. |
|
Mengatur catatan sertifikat SSL Server Name Indication (SNI) tertentu.
Windows 8 dan yang lebih baru: Nilai enumerasi ini didukung. |
|
Mengatur catatan sertifikat SSL yang menentukan bahwa Http.sys harus berkonsultasi dengan penyimpanan Penyimpanan Sertifikat Terpusat (CCS) untuk menemukan sertifikat jika port menerima jabat tangan Keamanan Lapisan Transportasi (TLS). Port ditentukan oleh anggota KeyDesc dari struktur HTTP_SERVICE_CONFIG_SSL_CCS_SET yang Anda berikan ke parameter pConfigInformation .
Windows 8 dan yang lebih baru: Nilai enumerasi ini didukung. |
[in] pConfigInformation
Penunjuk ke buffer yang berisi data yang sesuai untuk menentukan jenis catatan yang akan diatur.
Nilai ConfigId | Makna |
---|---|
|
HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM struktur. |
|
HTTP_SERVICE_CONFIG_SSL_SET struktur. |
|
HTTP_SERVICE_CONFIG_URLACL_SET struktur. |
|
HTTP_SERVICE_CONFIG_TIMEOUT_SET struktur. Windows Vista dan yang lebih baru: Struktur ini didukung. |
|
HTTP_SERVICE_CONFIG_SSL_SNI_SET struktur. Nama host akan menjadi "*" ketika penyimpanan sertifikat pusat SSL dikueri dan pengikatan kartubebas digunakan, dan nama host untuk SNI reguler. Windows 8 dan yang lebih baru: Struktur ini didukung. |
|
HTTP_SERVICE_CONFIG_SSL_CCS_SET struktur. Windows 8 dan yang lebih baru: Struktur ini didukung. |
[in] ConfigInformationLength
Ukuran, dalam byte, dari buffer pConfigInformation .
[in] pOverlapped
Parameter ini dicadangkan dan 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 |
---|---|
|
Rekaman yang ditentukan sudah ada, dan harus dihapus agar nilainya diatur ulang. |
|
Ukuran buffer yang ditentukan dalam parameter ConfigInformationLength tidak cukup. |
|
Parameter ServiceHandle tidak valid. |
|
Satu atau beberapa parameter yang disediakan dalam bentuk yang tidak dapat digunakan. |
|
Sertifikat SSL yang digunakan tidak valid. Ini hanya dapat terjadi jika parameter HttpServiceConfigSSLCertInfo digunakan. |
|
Kode kesalahan sistem yang ditentukan dalam WinError.h. |
Keterangan
Parameter konfigurasi yang diatur dengan HttpSetServiceConfiguration diterapkan ke semua aplikasi HTTP Server API pada komputer, dan bertahan ketika HTTP Server API dimatikan, atau ketika komputer dimulai ulang.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | 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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk