The R_FtpClearStatistics2 method is called by the client. In response, the server resets statistical data for the FTP server.
DWORD R_FtpClearStatistics2( [in, string, unique] INET_INFO_IMPERSONATE_HANDLE pszServer, [in] DWORD dwInstance );
pszServer: The custom binding handle for the target system, as specified in section 2.1.1. The value MUST NOT be used by the server implementation.
dwInstance: The ID of the protocol server instance whose statistical data is being cleared.
Return Values: The method returns 0 (ERROR_SUCCESS) to indicate success; otherwise, it returns a nonzero error code, as specified in [MS-ERREF] section 2.2 or [MS-ERREF] section 2.3.1. The most common error codes are listed in the following table.
|
Return value/code |
Description |
|---|---|
|
0x00000002 ERROR_FILE_NOT_FOUND |
The system cannot find the specified file. |
|
0x00000005 ERROR_ACCESS_DENIED |
Access is denied. |
|
0x00000426 ERROR_SERVICE_NOT_ACTIVE |
The service is not running. |
Exceptions Thrown: No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified in [MS-RPCE].
In response to this request from the client, the server MAY reset the statistical data for the FTP server if the return code indicates success. If the data is reset, a time stamp SHOULD be saved. This time stamp SHOULD be used to populate the TimeOfLastClear field of the FTP_STATISTICS_0 structure in subsequent calls to R_FtpQueryStatistics2.<14>