RasAdminPortClearStatistics (función)

[Esta función solo se proporciona para la compatibilidad con versiones anteriores con Windows NT Server 4.0. Devuelve ERROR_CALL_NOT_IMPLEMENTED en Windows Server 2003. Las aplicaciones deben usar la función MprAdminPortClearStats.]

La función RasAdminPortClearStatistics restablece los contadores que representan las distintas estadísticas notificadas por la función RasAdminPortGetInfo en la estructura RAS_PORT_STATISTICS. Los contadores se restablecen a cero y comienzan a acumularse.

Sintaxis

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

Parámetros

lpszServer [in]

Puntero a una cadena Unicode terminada en null que especifica el nombre del servidor RAS. Especifique el nombre con caracteres "\\" iniciales, con el formato \\nombreServidor.

lpszPort [in]

Puntero a una cadena Unicode terminada en null que especifica el nombre del puerto en el servidor.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.

Si la función no se ejecuta correctamente, el valor devuelto puede ser el código de error siguiente.

Valor	Significado
ERROR_DEV_NOT_EXIST	El puerto especificado no es válido.

No hay información de error extendida para esta función; no llame a GetLastError.

Comentarios

La función RasAdminPortClearStatistics borra las estadísticas del servidor, no de forma local dentro de la aplicación que realiza la llamada. Esto significa que las estadísticas también se restablecen para cualquier otra aplicación que supervise el puerto especificado.

Si el puerto lpszPort forma parte de una conexión de varios vínculos, RasAdminPortClearStatistics restablece las estadísticas del puerto especificado; la función también restablece las estadísticas acumulativas de la conexión de varios vínculos. Pero la función no afecta a las estadísticas individuales de otros puertos que forman parte de la conexión de varios vínculos.

Requisitos

Requisito	Valor
Finalización del soporte técnico de cliente	Windows 2000 Professional
Fin del soporte técnico del servidor	Windows 2000 Server
Encabezado	Rassapi.h
Biblioteca	Rassapi.lib
Archivo DLL	Rassapi.dll

Consulte también

Introducción al servicio de acceso remoto (RAS)

Funciones de administración del servidor RAS

RAS_PORT_STATISTICS

RasAdminPortGetInfo