Función WinHttpQueryConnectionGroup (winhttp.h)

  • Artículo

Recupera una descripción del estado actual de las conexiones de WinHttp.

Sintaxis

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

Parámetros

hInternet

Tipo: _In_ HINTERNET

Identificador de solicitud o identificador de conexión.

Si es un identificador de conexión, WinHttp asume que el host usa HTTPS de forma predeterminada. Pero puede pasar WINHTTP_QUERY_CONNECTION_GROUP_FLAG_INSECURE (0x00000000000000001ull) en ullFlags para indicar que desea conexiones que no sean HTTPS.

pGuidConnection

Tipo: _In_ GUID*

Guid opcional. Si se proporciona, solo se devuelven las conexiones que coinciden con el GUID. De lo contrario, la función devuelve todas las conexiones al host (especificadas en hInternet mediante un identificador de solicitud o un identificador de conexión).

ullFlags

Tipo: _In_ ULONGLONG

Banderas. Pase WINHTTP_QUERY_CONNECTION_GROUP_FLAG_INSECURE para indicar que desea conexiones que no son HTTPS (consulte hInternet).

ppResult

Tipo: _Inout_ PWINHTTP_QUERY_CONNECTION_GROUP_RESULT*

Dirección de un puntero a un WINHTTP_QUERY_CONNECTION_GROUP_RESULT, a través del cual se devuelven los resultados.

WinHttp realiza una asignación internamente, por lo que una vez que haya terminado con él, debe liberar este puntero llamando a WinHttpFreeQueryConnectionGroupResult.

Requisitos

   
Cliente mínimo compatible Windows Build 22000
Servidor mínimo compatible Windows Build 22000
Plataforma de destino Windows
Encabezado winhttp.h
Library Winhttp.lib
Archivo DLL Winhttp.dll

Consulte también