WinHttpQueryConnectionGroup-Funktion (winhttp.h)
Ruft eine Beschreibung des aktuellen Zustands der WinHttp-Verbindungen ab.
Syntax
WINHTTPAPI DWORD WinHttpQueryConnectionGroup(
HINTERNET hInternet,
const GUID *pGuidConnection,
ULONGLONG ullFlags,
PWINHTTP_QUERY_CONNECTION_GROUP_RESULT *ppResult
);
Parameter
hInternet
Typ: _In_ HINTERNET
Ein Anforderungshandle oder ein Verbindungshandle.
Bei einem Verbindungshandle geht WinHttp davon aus, dass der Host standardmäßig HTTPS verwendet. Sie können jedoch WINHTTP_QUERY_CONNECTION_GROUP_FLAG_INSECURE (0x0000000000000000001ull) in ullFlags übergeben, um anzugeben, dass Sie Verbindungen ohne HTTPS verwenden möchten.
pGuidConnection
Typ: _In_ GUID*
Eine optionale GUID. Wenn angegeben, werden nur Verbindungen zurückgegeben, die der GUID entsprechen. Andernfalls gibt die Funktion alle Verbindungen mit dem Host zurück (angegeben in hInternet entweder durch ein Anforderungshandle oder ein Verbindungshandle).
ullFlags
Typ: _In_ ULONGLONG
Flaggen. Übergeben Sie WINHTTP_QUERY_CONNECTION_GROUP_FLAG_INSECURE , um anzugeben, dass Keine-HTTPS-Verbindungen hergestellt werden sollen (siehe hInternet).
ppResult
Typ: _Inout_ PWINHTTP_QUERY_CONNECTION_GROUP_RESULT*
Die Adresse eines Zeigers auf einen WINHTTP_QUERY_CONNECTION_GROUP_RESULT, über den die Ergebnisse zurückgegeben werden.
WinHttp führt intern eine Zuordnung aus. Sobald Sie damit fertig sind, müssen Sie diesen Zeiger durch Aufrufen von WinHttpFreeQueryConnectionGroupResult freigeben.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Build 22000 |
| Unterstützte Mindestversion (Server) | Windows Build 22000 |
| Zielplattform | Windows |
| Kopfzeile | winhttp.h |
| Bibliothek | Winhttp.lib |
| DLL | Winhttp.dll |