Fungsi HttpSetServiceConfiguration (http.h)

Artikel
08/24/2023

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
HttpServiceConfigIPListenList	Mengatur catatan di Daftar Dengar IP.
HttpServiceConfigSSLCertInfo	Mengatur catatan sertifikat SSL tertentu.
HttpServiceConfigUrlAclInfo	Mengatur catatan reservasi URL.
HttpServiceConfigTimeout	Mengatur batas waktu koneksi luas API Server HTTP yang ditentukan. Windows Vista dan yang lebih baru: Nilai enumerasi ini didukung.
HttpServiceConfigSslSniCertInfo	Mengatur catatan sertifikat SSL Server Name Indication (SNI) tertentu. Windows 8 dan yang lebih baru: Nilai enumerasi ini didukung.
HttpServiceConfigSslCcsCertInfo	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
HttpServiceConfigIPListenList	HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM struktur.
HttpServiceConfigSSLCertInfo	HTTP_SERVICE_CONFIG_SSL_SET struktur.
HttpServiceConfigUrlAclInfo	HTTP_SERVICE_CONFIG_URLACL_SET struktur.
HttpServiceConfigTimeout	HTTP_SERVICE_CONFIG_TIMEOUT_SET struktur. Windows Vista dan yang lebih baru: Struktur ini didukung.
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 reguler. Windows 8 dan yang lebih baru:* Struktur ini didukung.
HttpServiceConfigSslCcsCertInfo	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
ERROR_ALREADY_EXISTS	Rekaman yang ditentukan sudah ada, dan harus dihapus agar nilainya diatur ulang.
ERROR_INSUFFICIENT_BUFFER	Ukuran buffer yang ditentukan dalam parameter ConfigInformationLength 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 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

HttpDeleteServiceConfiguration

HttpQueryServiceConfiguration

HttpUpdateServiceConfiguration

Share via