Функция WinHttpQueryConnectionGroup (winhttp.h)

Получает описание текущего состояния подключений WinHttp.

Синтаксис

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

Параметры

hInternet

Тип: _In_ HINTERNET

Дескриптор запроса или дескриптор подключения.

Если используется дескриптор подключения, winHttp предполагает, что узел по умолчанию использует ПРОТОКОЛ HTTPS. Но вы можете передать WINHTTP_QUERY_CONNECTION_GROUP_FLAG_INSECURE (0x0000000000000001ull) в ullFlags , чтобы указать, что требуется подключение, отличное от HTTPS.

pGuidConnection

Тип: _In_ GUID*

Необязательный ИДЕНТИФИКАТОР GUID. Если указано, возвращаются только подключения, соответствующие GUID. В противном случае функция возвращает все подключения к узлу (указанные в hInternet дескриптором запроса или дескриптором подключения).

ullFlags

Тип: _In_ ULONGLONG

Флаги. Передайте WINHTTP_QUERY_CONNECTION_GROUP_FLAG_INSECURE , чтобы указать, что требуется использовать подключения, отличные от HTTPS (см. раздел hInternet).

ppResult

Тип: _Inout_ PWINHTTP_QUERY_CONNECTION_GROUP_RESULT*

Адрес указателя на WINHTTP_QUERY_CONNECTION_GROUP_RESULT, по которому возвращаются результаты.

WinHttp выполняет внутреннее выделение, поэтому после завершения работы с ним необходимо освободить этот указатель, вызвав WinHttpFreeQueryConnectionGroupResult.

Требования

Минимальная версия клиента	Сборка Windows 22000
Минимальная версия сервера	Сборка Windows 22000
Целевая платформа	Windows
Header	winhttp.h
Библиотека	Winhttp.lib
DLL	Winhttp.dll

См. также раздел

• WINHTTP_QUERY_CONNECTION_GROUP_RESULT
• WinHttpFreeQueryConnectionGroupResult