3.2.4.3.9 RegisterAccountingClient (Opnum 15)
The RegisterAccountingClient method registers an accounting client for remote accounting on an accounting server. A default accounting database SHOULD<50> be defined.
Note This method is expected to be called remotely by the WSRM management service that is acting as an accounting client. A client SHOULD NOT call this method.
-
[id(9), helpstring("method RegisterAccountingClient")] HRESULT RegisterAccountingClient( [in] BSTR bstrClientId );
bstrClientId: A string that specifies a client machine name.
-
If this parameter is NULL, E_INVALIDARG MUST be returned.
Return Values: This method returns 0x00000000 for success, or a negative HRESULT value (in the following table or in [MS-ERREF] section 2.1.1) if an error occurs.
-
Return value/code
Description
0x00000000
S_OK
Operation successful.
0x80070057
E_INVALIDARG
One or more arguments are invalid.
0xC1FF0209
WRM_ERR_ACC_DISABLED_FOR_REMOTE_CLIENT
WSRM encountered an error in accounting.
0xC1FF020C
WRM_ERR_REMOTE_SERVICE_NOT_SETUP_FOR_REMOTING
Connection to the remote server could not be established. The server is not set up for remote accounting.
This error is returned when an accounting client is trying to register itself on an accounting server machine which itself is an accounting client.<51>
0xC1FF0212
WRM_ERR_INVALID_OPERATION
The operation is invalid.
This error is returned when a WSRM management service acting as an accounting client tries to register itself twice, as when this method is called with the same DCOM interface instance.
0xC1FF0216
WRM_ERR_DBSERVER_CANNOT_BE_REMOTE
Data cannot be logged on the remote system.
This error is returned when an accounting client calls this method on the accounting server but accounting is not yet initialized.<52>
It is possible for multiple WSRM servers to act as accounting clients and have a common accounting database server.
Note Remote accounting is not supported in a workgroup environment.
Additional IWRMAccounting interface methods are specified in section 3.2.4.3.