Fonction WinHttpQueryConnectionGroup (winhttp.h)

Récupère une description de l’état actuel des connexions de WinHttp.

Syntaxe

WINHTTPAPI DWORD WinHttpQueryConnectionGroup(
  HINTERNET                              hInternet,
  const GUID                             *pGuidConnection,
  ULONGLONG                              ullFlags,
  PWINHTTP_QUERY_CONNECTION_GROUP_RESULT *ppResult
);

Paramètres

hInternet

Type : _In_ HINTERNET

Un handle de requête ou un handle de connexion.

Si un handle de connexion, WinHttp suppose que l’hôte utilise HTTPS par défaut. Mais vous pouvez passer WINHTTP_QUERY_CONNECTION_GROUP_FLAG_INSECURE (0x0000000000001ull) dans ullFlags pour indiquer que vous souhaitez des connexions non HTTPS.

pGuidConnection

Type : _In_ GUID*

GUID facultatif. Si elle est fournie, seules les connexions correspondant au GUID sont retournées. Sinon, la fonction retourne toutes les connexions à l’hôte (spécifiées dans hInternet par un handle de requête ou un handle de connexion).

ullFlags

Type : _In_ ULONGLONG

Drapeaux. Passez WINHTTP_QUERY_CONNECTION_GROUP_FLAG_INSECURE pour indiquer que vous souhaitez des connexions non HTTPS (voir hInternet).

ppResult

Type : _Inout_ PWINHTTP_QUERY_CONNECTION_GROUP_RESULT*

Adresse d’un pointeur vers un WINHTTP_QUERY_CONNECTION_GROUP_RESULT, par le biais duquel les résultats sont retournés.

WinHttp effectue une allocation en interne. Une fois que vous avez terminé, vous devez libérer ce pointeur en appelant WinHttpFreeQueryConnectionGroupResult.

Configuration requise

Voir aussi

• WINHTTP_QUERY_CONNECTION_GROUP_RESULT
• WinHttpFreeQueryConnectionGroupResult