Compartilhar via


Função RasClearLinkStatistics (ras.h)

As funções RasClearLinkStatistics limpam todas as estatísticas acumuladas para o link especificado em uma conexão multilink ras.

Sintaxe

DWORD RasClearLinkStatistics(
  [in] HRASCONN hRasConn,
  [in] DWORD    dwSubEntry
);

Parâmetros

[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 limpar estatísticas.

Retornar valor

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
ERROR_INVALID_HANDLE
O parâmetro hRasConn não especifica uma conexão válida.
ERROR_INVALID_PARAMETER
O parâmetro dwSubEntry é zero.
ERROR_NO_CONNECTION
A RAS não pôde encontrar uma porta conectada que corresponda ao valor no parâmetro dwSubEntry .
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.

Requisitos

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

Confira também

RasClearConnectionStatistics

RasGetLinkStatistics

Visão geral do RAS (Serviço de Acesso Remoto)

Funções do serviço de acesso remoto