Fungsi HttpDeleteServiceConfiguration (http.h)

Artikel
08/24/2023

Fungsi HttpDeleteServiceConfiguration menghapus data tertentu, seperti alamat IP atau Sertifikat SSL, dari penyimpanan konfigurasi HTTP Server API, satu rekaman pada satu waktu.

Sintaks

HTTPAPI_LINKAGE ULONG HttpDeleteServiceConfiguration(
  [in] HANDLE                 ServiceHandle,
  [in] HTTP_SERVICE_CONFIG_ID ConfigId,
  [in] PVOID                  pConfigInformation,
  [in] ULONG                  ConfigInformationLength,
  [in] LPOVERLAPPED           pOverlapped
);

Parameter

[in] ServiceHandle

Parameter ini dicadangkan dan harus nol.

[in] ConfigId

Jenis konfigurasi. Parameter ini adalah salah satu nilai dalam enumerasi HTTP_SERVICE_CONFIG_ID .

Nilai ConfigId	Makna
HttpServiceConfigIPListenList	Menghapus alamat IP tertentu dari Daftar Dengar IP.
HttpServiceConfigSSLCertInfo	Menghapus rekaman sertifikat SSL tertentu.
HttpServiceConfigUrlAclInfo	Menghapus catatan reservasi URL tertentu.
HttpServiceConfigTimeout	Menghapus batas waktu koneksi tertentu. Windows Vista dan yang lebih baru: Enumerasi ini didukung.
HttpServiceConfigSslSniCertInfo	Menghapus rekaman sertifikat SSL Server Name Indication (SNI) tertentu. Windows 8 dan yang lebih baru: Nilai enumerasi ini didukung.
HttpServiceConfigSslCcsCertInfo	Menghapus rekaman 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 diperlukan untuk jenis konfigurasi yang ditentukan dalam parameter ConfigId .

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.
HttpServiceConfigTimeouts	HTTP_SERVICE_CONFIG_TIMEOUT_KEY 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

Dicadangkan untuk operasi asinkron di masa mendatang. Parameter ini harus diatur ke NULL.

Menampilkan nilai

Jika fungsi berhasil, fungsi akan mengembalikan NO_ERROR.

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

Nilai	Makna
ERROR_INVALID_PARAMETER	Salah satu parameter tidak valid.
Lainnya	Kode kesalahan sistem yang ditentukan dalam WinError.h.

Persyaratan


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

HttpQueryServiceConfiguration

HttpSetServiceConfiguration

HttpUpdateServiceConfiguration

Bagikan melalui