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를 사용한다고 가정합니다. 그러나 ullFlags에서 WINHTTP_QUERY_CONNECTION_GROUP_FLAG_INSECURE(0x0000000000000001ull)를 전달하여 비 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 Build 22000
지원되는 최소 서버 Windows Build 22000
대상 플랫폼 Windows
헤더 winhttp.h
라이브러리 Winhttp.lib
DLL Winhttp.dll

추가 정보