共用方式為

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來釋放此指標。

規格需求

   
最低支援的用戶端 Windows 組建 22000
最低支援的伺服器 Windows 組建 22000
目標平台 Windows
標頭 winHTTP.h
程式庫 WinHTTP.lib
Dll Winhttp.dll

另請參閱