Platform SDK: RAS/Routing and RAS |
The RasAdminPortClearStatistics function resets the counters representing the various statistics reported by the RasAdminPortGetInfo function in the RAS_PORT_STATISTICS structure. The counters are reset to zero and start accumulating from then on.
DWORD RasAdminPortClearStatistics( const WCHAR *lpszServer, // pointer to the server name const WCHAR *lpszPort // pointer to the name of port on the server );
If the function succeeds, the return value is ERROR_SUCCESS.
If the function fails, the return value can be the following error code.
Value | Meaning |
---|---|
ERROR_DEV_NOT_EXIST | The specified port is invalid. |
There is no extended error information for this function; do not call GetLastError.
The RasAdminPortClearStatistics function clears the statistics on the server, not locally within the application that makes the call. This means that the statistics are also reset for any other application that is monitoring the specified port.
If the lpszPort port is part of a multilink connection, RasAdminPortClearStatistics resets the statistics for the specified port, The function also resets the cumulative statistics for the multilink connection. However, the function does not effect the individual statistics for other ports that are part of the multilink connection.
Windows NT/2000: Requires Windows NT 4.0 or later.
Header: Declared in Rassapi.h.
Library: Use Rassapi.lib.
Remote Access Service (RAS) Overview, RAS Server Administration Functions, RAS_PORT_STATISTICS, RasAdminPortGetInfo