Bagikan melalui

Fungsi HttpQueryServiceConfiguration (http.h)

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

  • Last updated on