Função RasGetLinkStatistics (ras.h)

A função RasGetLinkStatistics recupera estatísticas acumuladas para o link especificado em uma conexão multilink ras.

Sintaxe

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

[in] hRasConn

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

[in] dwSubEntry

Especifica a subentidade que corresponde ao link para o qual recuperar estatísticas.

[in, out] lpStatistics

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

Na entrada, o membro dwSize dessa estrutura especifica o tamanho de RAS_STATS. Use sizeof(RAS_STATS) para obter esse tamanho.

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_INVALID_ARG	Pelo menos um dos seguintes é verdadeiro: o parâmetro hRasConn é zero, o parâmetro dwSubEntry é 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