Fungsi WinHttpQueryConnectionGroup (winhttp.h)

Mengambil deskripsi status koneksi WinHttp saat ini.

Sintaks

WINHTTPAPI DWORD WinHttpQueryConnectionGroup(
  HINTERNET                              hInternet,
  const GUID                             *pGuidConnection,
  ULONGLONG                              ullFlags,
  PWINHTTP_QUERY_CONNECTION_GROUP_RESULT *ppResult
);

Parameter

hInternet

Jenis: _In_ HINTERNET

Handel permintaan atau handel sambungkan.

Jika handel sambungkan, maka WinHttp mengasumsikan bahwa host menggunakan HTTPS secara default. Tetapi Anda dapat meneruskan WINHTTP_QUERY_CONNECTION_GROUP_FLAG_INSECURE (0x000000000000001ull) di ullFlags untuk menunjukkan bahwa Anda ingin koneksi non-HTTPS.

pGuidConnection

Jenis: _In_ GUID*

GUID opsional. Jika disediakan, maka hanya koneksi yang cocok dengan GUID yang dikembalikan. Jika tidak, fungsi mengembalikan semua koneksi ke host (ditentukan dalam hInternet baik oleh handel permintaan atau handel koneksi).

ullFlags

Jenis: _In_ ULONGLONG

Bendera. Teruskan WINHTTP_QUERY_CONNECTION_GROUP_FLAG_INSECURE untuk menunjukkan bahwa Anda menginginkan koneksi non-HTTPS (lihat hInternet).

ppResult

Jenis: _Inout_ PWINHTTP_QUERY_CONNECTION_GROUP_RESULT*

Alamat penunjuk ke WINHTTP_QUERY_CONNECTION_GROUP_RESULT, di mana hasilnya dikembalikan.

WinHttp melakukan alokasi secara internal, jadi setelah selesai, Anda harus membebaskan pointer ini dengan memanggil WinHttpFreeQueryConnectionGroupResult.

Persyaratan

Klien minimum yang didukung	Windows Build 22000
Server minimum yang didukung	Windows Build 22000
Target Platform	Windows
Header	winhttp.h
Pustaka	Winhttp.lib
DLL	Winhttp.dll

Lihat juga

• WINHTTP_QUERY_CONNECTION_GROUP_RESULT
• WinHttpFreeQueryConnectionGroupResult