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
Library Winhttp.lib
[DLL] Winhttp.dll

関連項目