MprAdminConnectionClearStats function (mprapi.h)

The MprAdminConnectionClearStats function resets the statistics counters for the specified connection.

Syntax

DWORD MprAdminConnectionClearStats(
  [in] RAS_SERVER_HANDLE hRasServer,
  [in] HANDLE            hRasConnection
);

Parameters

[in] hRasServer

Handle to the Remote Access Server on which to execute MprAdminConnectionClearStats. Obtain this handle by calling MprAdminServerConnect.

[in] hRasConnection

Handle to the connection for which to reset the statistics. Obtain this handle by calling MprAdminConnectionEnum.

Return value

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value is one of the following error codes.

Value Meaning
ERROR_ACCESS_DENIED
The calling application does not have sufficient privileges.
ERROR_DDM_NOT_RUNNING
The Demand Dial Manager (DDM) is not running, possibly because the Dynamic Interface Manager (DIM) is configured to run only on a LAN.
ERROR_INVALID_PARAMETER
The handle to the port is invalid.
RPC_S_INVALID_BINDING
This function was called with hRasServer parameter equal to NULL.
Other
An error from MprError.h, RasError.h, or WinError.h.
 
 

Remarks

This function is available on Windows NT 4.0 if the RRAS redistributable is installed. However, the version of Mprapi.dll that ships with the RRAS redistributable exports the function as RasAdminConnectionClearStats rather than MprAdminConnectionClearStats. Therefore, when using the RRAS redistributable, use LoadLibrary and GetProcAddress to access this function.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header mprapi.h
Library Mprapi.lib
DLL Mprapi.dll

See also

MprAdminConnectionEnum

MprAdminServerConnect

RAS Administration Functions

Remote Access Service Administration Reference