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 |