Compartilhar via


Função RAS RasAdminPortClearStatistics

[Esta função é fornecida apenas para compatibilidade com versões anteriores com o Windows NT Server 4.0. Ele retorna ERROR_CALL_NOT_IMPLEMENTED no Windows Server 2003. Os aplicativos devem usar a função MprAdminPortClearStats.]

A função RasAdminPortClearStatistics redefine os contadores que representam as várias estatísticas relatadas pela função RasAdminPortGetInfo na estrutura RAS_PORT_STATISTICS. Os contadores são redefinidos para zero e começam a se acumular.

Sintaxe

DWORD RasAdminPortClearStatistics(
  _In_ const WCHAR *lpszServer,
  _In_ const WCHAR *lpszPort
);

Parâmetros

lpszServer [in]

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o nome do servidor RAS. Especifique o nome com caracteres "\\" com espaçamento entre linhas à esquerda, no formato: \\nomedoservidor.

lpszPort [in]

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o nome da porta no servidor.

Valor retornado

Se a função obtiver êxito, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor retornado poderá ser o código de erro a seguir.

Valor Significado
ERROR_DEV_NOT_EXIST
A porta especificada é inválida.

Não há nenhuma informação de erro estendida para esta função; não chame GetLastError.

Comentários

A função RasAdminPortClearStatistics limpa as estatísticas no servidor, não localmente dentro do aplicativo que faz a chamada. Isso significa que as estatísticas também são redefinidas para qualquer outro aplicativo que esteja monitorando a porta especificada.

Se a porta lpszPort fizer parte de uma conexão multilink, RasAdminPortClearStatistics redefinirá as estatísticas da porta especificada. A função também redefinirá as estatísticas cumulativas para a conexão multilink. No entanto, a função não afetará as estatísticas individuais para outras portas que fazem parte da conexão multilink.

Requisitos

Requisito Valor
Fim do suporte ao cliente
Windows 2000 Professional
Encerramento do suporte ao servidor
Windows 2000 Server
Cabeçalho
Rassapi.h
Biblioteca
Rassapi.lib
DLL
Rassapi.dll

Confira também

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

Funções de administração do servidor RAS

RAS_PORT_STATISTICS

RasAdminPortGetInfo