Bagikan melalui

Fungsi HttpSetServiceConfiguration (http.h)

Fungsi HttpSetServiceConfiguration membuat dan mengatur catatan konfigurasi untuk penyimpanan konfigurasi HTTP Server API. Panggilan gagal jika rekaman yang ditentukan sudah ada. Untuk mengubah rekaman konfigurasi tertentu, hapus lalu buat ulang dengan nilai yang berbeda.

Syntax

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

Parameter-parameternya

[in] ServiceHandle

Direservasi. Harus nol.

[in] ConfigId

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

Nilai ConfigId Meaning
HttpServiceConfigIPListenList
 Mengatur catatan di Daftar Dengar IP.
HttpServiceConfigSSLCertInfo
 Mengatur catatan sertifikat SSL tertentu.
HttpServiceConfigUrlAclInfo
 Mengatur catatan reservasi URL.
HttpServiceConfigTimeout
 Mengatur batas waktu koneksi luas HTTP Server API tertentu.

Windows Vista dan yang lebih baru: Nilai enumerasi ini didukung.
HttpServiceConfigSslSniCertInfo
 Mengatur catatan sertifikat Indikasi Nama Server (SNI) SSL 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 teruskan 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 Meaning
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.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah NO_ERROR.

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

Nilai Meaning
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.

Komentar

Parameter konfigurasi yang diatur dengan HttpSetServiceConfiguration diterapkan ke semua aplikasi HTTP Server API pada komputer, dan bertahan saat API Server HTTP dimatikan, atau ketika komputer dimulai ulang.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP dengan SP2 [khusus aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Platform Target Windows
Header http.h
Library Httpapi.lib
DLL Httpapi.dll

Lihat juga

Fungsi HTTP Server API Versi 1.0

HttpDeleteServiceConfiguration

HttpQueryServiceConfiguration

HttpUpdateServiceConfiguration

  • Last updated on