Função RasGetConnectionStatistics (ras.h)

A função RasGetConnectionStatistics recupera estatísticas de conexão acumuladas para a conexão especificada.

Sintaxe

DWORD RasGetConnectionStatistics(
  [in]      HRASCONN  hRasConn,
  [in, out] RAS_STATS *lpStatistics
);

[in] hRasConn

Manipule para a conexão. Use RasDial ou RasEnumConnections para obter esse identificador.

[in, out] lpStatistics

Ponteiro para a estrutura RAS_STATS que, na saída, recebe as estatísticas.

Na entrada, defina o membro dwSize dessa estrutura como sizeof(RAS_STATS).

Esse parâmetro não pode ser NULL.

Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor retornado será um dos seguintes códigos de erro ou um valor de Códigos de Erro de Roteamento e Acesso Remoto ou Winerror.h.

Valor	Significado
E_INVALIDARG	Pelo menos um dos seguintes é verdadeiro: o parâmetro hRasConn é zero, o parâmetro lpStatistics é NULL ou o valor especificado pelo membro dwSize da estrutura RAS_STATS especifica uma versão da estrutura que não tem suporte do sistema operacional em uso.
ERROR_NOT_ENOUGH_MEMORY	A função não pôde alocar memória suficiente para concluir a operação.
Outros	Use FormatMessage para recuperar a mensagem de erro do sistema que corresponde ao código de erro retornado.

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	ras.h
Biblioteca	Rasapi32.lib
DLL	Rasapi32.dll