Share via

3.2.4.3.9 RegisterAccountingClient (Opnum 15)

  • Article

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.