Fungsi HttpQueryServiceConfiguration (http.h)

Artikel
01/10/2024

Fungsi HttpQueryServiceConfiguration mengambil satu atau beberapa rekaman konfigurasi HTTP Server API.

Sintaks

HTTPAPI_LINKAGE ULONG HttpQueryServiceConfiguration(
  [in]                HANDLE                 ServiceHandle,
  [in]                HTTP_SERVICE_CONFIG_ID ConfigId,
  [in, optional]      PVOID                  pInput,
  [in, optional]      ULONG                  InputLength,
  [in, out, optional] PVOID                  pOutput,
  [in, optional]      ULONG                  OutputLength,
  [out, optional]     PULONG                 pReturnLength,
  [in]                LPOVERLAPPED           pOverlapped
);

Parameter

[in] ServiceHandle

Dicadangkan. Harus nol.

[in] ConfigId

Jenis kueri rekaman konfigurasi. Parameter ini adalah salah satu nilai berikut dari
HTTP_SERVICE_CONFIG_ID enumerasi.

Nilai ConfigId	Makna
HttpServiceConfigIPListenList	Mengkueri Daftar Dengar IP.
HttpServiceConfigSSLCertInfo	Mengkueri penyimpanan SSL untuk rekaman sertifikat tertentu.
HttpServiceConfigUrlAclInfo	Mengkueri informasi reservasi URL.
HttpServiceConfigTimeout	Kueri batas waktu koneksi luas HTTP Server API. Windows Vista dan yang lebih baru: Enumerasi ini didukung.
HttpServiceConfigSslSniCertInfo	Mengkueri penyimpanan Indikasi Nama Server (SNI) SSL untuk rekaman sertifikat tertentu. Windows 8 dan yang lebih baru: Nilai enumerasi ini didukung.
HttpServiceConfigSslCcsCertInfo	Mengkueri konfigurasi SSL untuk catatan SSL Centralized Certificate Store (CCS) pada port. Port ditentukan oleh anggota KeyDesc dari struktur HTTP_SERVICE_CONFIG_SSL_CCS_QUERY yang Anda berikan ke parameter pInputConfigInfo . Windows 8 dan yang lebih baru: Nilai enumerasi ini didukung.

[in, optional] pInput

Penunjuk ke struktur yang kontennya lebih lanjut menentukan kueri dan jenis yang berkorelasi dengan ConfigId dalam tabel berikut.

Nilai ConfigId	Makna
HttpServiceConfigIPListenList	Tidak ada data input; atur ke NULL.
HttpServiceConfigSSLCertInfo	HTTP_SERVICE_CONFIG_SSL_QUERY struktur.
HttpServiceConfigUrlAclInfo	HTTP_SERVICE_CONFIG_URLACL_QUERY struktur.
HttpServiceConfigTimeout	HTTP_SERVICE_CONFIG_TIMEOUT_KEY struktur. Windows Vista dan yang lebih baru: Struktur ini didukung.
HttpServiceConfigSslSniCertInfo	HTTP_SERVICE_CONFIG_SSL_SNI_QUERY struktur. Windows 8 dan yang lebih baru: Struktur ini didukung.
HttpServiceConfigSslCcsCertInfo	HTTP_SERVICE_CONFIG_SSL_CCS_QUERY struktur. Windows 8 dan yang lebih baru: Struktur ini didukung.

Untuk informasi selengkapnya, lihat struktur kueri yang sesuai.

[in, optional] InputLength

Ukuran, dalam byte, dari buffer pInputConfigInfo .

[in, out, optional] pOutput

Penunjuk ke buffer tempat hasil kueri dikembalikan. Jenis buffer ini berkorelasi dengan ConfigId.

Nilai ConfigId	Makna
HttpServiceConfigIPListenList	HTTP_SERVICE_CONFIG_IP_LISTEN_QUERY struktur.
HttpServiceConfigSSLCertInfo	HTTP_SERVICE_CONFIG_SSL_SET struktur.
HttpServiceConfigUrlAclInfo	HTTP_SERVICE_CONFIG_URLACL_SET struktur.
HttpServiceConfigTimeout	HTTP_SERVICE_CONFIG_TIMEOUT_PARAM jenis data. Windows Vista dan yang lebih baru: Struktur ini didukung.
HttpServiceConfigSslSniCertInfo	HTTP_SERVICE_CONFIG_SSL_SNI_SET struktur. 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, optional] OutputLength

Ukuran, dalam byte, dari buffer pOutputConfigInfo .

[out, optional] pReturnLength

Penunjuk ke variabel yang menerima jumlah byte yang akan ditulis dalam buffer output. Jika buffer output terlalu kecil, panggilan gagal dengan nilai pengembalian ERROR_INSUFFICIENT_BUFFER. Nilai yang ditujukan oleh pReturnLength dapat digunakan untuk menentukan panjang minimum yang diperlukan buffer agar panggilan berhasil.

[in] pOverlapped

Dicadangkan untuk operasi asinkron dan harus diatur ke 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_INVALID_PARAMETER	Salah satu parameter tidak valid.
ERROR_INSUFFICIENT_BUFFER	Buffer yang diacu oleh pOutputConfigInfo terlalu kecil untuk menerima data output. Panggil fungsi lagi dengan buffer setidaknya sebesar ukuran yang diacu oleh pReturnLength saat keluar.
ERROR_MORE_DATA	Buffer yang diacu oleh pOutputConfigInfo terlalu kecil untuk menerima data output. Panggil fungsi lagi dengan buffer setidaknya sebesar ukuran yang diacu oleh pReturnLength saat keluar.
ERROR_NO_MORE_ITEMS	Tidak ada lagi item untuk dikembalikan yang memenuhi kriteria yang ditentukan.
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

HttpDeleteServiceConfiguration

HttpSetServiceConfiguration

HttpUpdateServiceConfiguration

Share via