Fungsi HttpUpdateServiceConfiguration (http.h)

Artikel
03/05/2024

Updates parameter konfigurasi layanan secara atomik yang menentukan sertifikat Keamanan Lapisan Transportasi (TLS) dalam catatan konfigurasi dalam penyimpanan konfigurasi HTTP Server API.

Sintaks

HTTPAPI_LINKAGE ULONG HttpUpdateServiceConfiguration(
  [in] HANDLE                 Handle,
  [in] HTTP_SERVICE_CONFIG_ID ConfigId,
  [in] PVOID                  ConfigInfo,
  [in] ULONG                  ConfigInfoLength,
  [in] LPOVERLAPPED           Overlapped
);

Parameter

[in] Handle

Dicadangkan dan harus NULL.

[in] ConfigId

Jenis catatan konfigurasi yang akan diperbarui. Parameter ini bisa menjadi salah satu nilai berikut dari enumerasi HTTP_SERVICE_CONFIG_ID .

Nilai ConfigId	Makna
HttpServiceConfigSSLCertInfo	Updates rekaman sertifikat SSL tertentu.
HttpServiceConfigSslSniCertInfo	Updates catatan sertifikat Indikasi Nama Server (SNI) SSL tertentu.
HttpServiceConfigSslCcsCertInfo	Updates rekaman sertifikat SSL yang menentukan bahwa Http.sys harus berkonsultasi dengan penyimpanan Penyimpanan Sertifikat Terpusat (CCS) untuk menemukan sertifikat jika port menerima jabat tangan TLS. Port ditentukan oleh anggota KeyDesc dari struktur HTTP_SERVICE_CONFIG_SSL_CCS_SET yang Anda berikan ke parameter pConfigInfo .

[in] ConfigInfo

Penunjuk ke buffer yang berisi data yang sesuai untuk menentukan jenis rekaman yang akan diperbarui. Tabel berikut ini memperlihatkan jenis data yang dikandung buffer untuk berbagai nilai yang mungkin dari parameter ConfigId .

Nilai ConfigId	Jenis data dalam buffer pConfigInfo
HttpServiceConfigSSLCertInfo	HTTP_SERVICE_CONFIG_SSL_SET struktur.
HttpServiceConfigSslSniCertInfo	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 biasa.
HttpServiceConfigSslCcsCertInfo	HTTP_SERVICE_CONFIG_SSL_CCS_SET struktur. Struktur ini digunakan untuk menambahkan penyimpanan CCS pada port yang ditentukan, serta untuk menghapus, mengambil, atau memperbarui catatan SSL CCS yang ada.

[in] ConfigInfoLength

Ukuran, dalam byte, dari buffer ConfigInfo .

[in] Overlapped

Dicadangkan dan harus NULL.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut.

Nilai	Makna
ERROR_FILE_NOT_FOUND	Rekaman yang ditentukan tidak ada.
ERROR_INSUFFICIENT_BUFFER	Ukuran buffer yang ditentukan dalam parameter ConfigInfoLength tidak cukup.
ERROR_INVALID_HANDLE	Parameter ServiceHandle tidak valid.
ERROR_INVALID_PARAMETER	Satu atau beberapa parameter yang disediakan dalam bentuk yang tidak dapat digunakan.
ERROR_NO_SUCH_LOGON_SESSION	Sertifikat SSL yang digunakan tidak valid. Ini hanya dapat terjadi jika parameter HttpServiceConfigSSLCertInfo digunakan.
Lainnya	Kode kesalahan sistem yang ditentukan dalam WinError.h.

Keterangan

Parameter konfigurasi yang Anda perbarui dengan HttpUpdateServiceConfiguration diterapkan ke semua aplikasi HTTP Server API pada komputer, dan bertahan saat HTTP Server API dimatikan, atau saat komputer dimulai ulang.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10, versi 1703 [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	http.h
Pustaka	Httpapi.lib
DLL	Httpapi.dll