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 (0x00000000000000001ull) ，以指示需要非 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 来释放此指针。

要求

另请参阅

• WINHTTP_QUERY_CONNECTION_GROUP_RESULT
• WinHttpFreeQueryConnectionGroupResult