Функция 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 |