Função WinHttpQueryConnectionGroup (winhttp.h)

Recupera uma descrição do estado atual das conexões do WinHttp.

Sintaxe

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

Parâmetros

hInternet

Tipo: _In_ HINTERNET

Um identificador de solicitação ou um identificador de conexão.

Se um identificador de conexão, o WinHttp pressupõe que o host use HTTPS por padrão. Mas você pode passar WINHTTP_QUERY_CONNECTION_GROUP_FLAG_INSECURE (0x00000000000000001ull) em ullFlags para indicar que você deseja conexões não HTTPS.

pGuidConnection

Tipo: _In_ GUID*

Um GUID opcional. Se fornecido, somente as conexões correspondentes ao GUID serão retornadas. Caso contrário, a função retorna todas as conexões com o host (especificado em hInternet por um identificador de solicitação ou um identificador de conexão).

ullFlags

Tipo: _In_ ULONG

Sinalizadores. Passe WINHTTP_QUERY_CONNECTION_GROUP_FLAG_INSECURE para indicar que você deseja conexões não HTTPS (consulte hInternet).

ppResult

Tipo: _Inout_ PWINHTTP_QUERY_CONNECTION_GROUP_RESULT*

O endereço de um ponteiro para um WINHTTP_QUERY_CONNECTION_GROUP_RESULT, por meio do qual os resultados são retornados.

O WinHttp executa uma alocação internamente, portanto, depois de terminar com ele, você deve liberar esse ponteiro chamando WinHttpFreeQueryConnectionGroupResult.

Requisitos

Cliente mínimo com suporte	Windows Build 22000
Servidor mínimo com suporte	Windows Build 22000
Plataforma de Destino	Windows
Cabeçalho	winhttp.h
Biblioteca	Winhttp.lib
DLL	Winhttp.dll

Confira também

• WINHTTP_QUERY_CONNECTION_GROUP_RESULT
• WinHttpFreeQueryConnectionGroupResult