Freigeben über

WinHttpQueryConnectionGroup-Funktion (winhttp.h)

  • Artikel

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

Weitere Informationen