3.2.4.3.5 GetNextAccountingDataBatch (Opnum 11)

The GetNextAccountingDataBatch method gets the next batch of data in a previously initiated query to the accounting database.<45>

 [id(5), helpstring("method GetNextAccountingDataBatch")] HRESULT GetNextAccountingDataBatch(
   [out] BSTR* pbstrResult,
   [out] BOOL* pbIsThereMoreData
 );

pbstrResult: A pointer to a string that returns the requested data.

pbIsThereMoreData: A pointer to a Boolean value that specifies whether more data is available.

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.

0x81FF0217

WRM_WRN_WSRM_INCOMPLETE_FETCH

Data was fetched incompletely; the connection to the database might have terminated.

0xC1FF01FA

WRM_ERR_WYUKON_NOT_CONNECTABLE

Cannot establish a connection to the accounting database.

0xC1FF0203

WRM_ERR_JET_SERVER_TOO_BUSY

The server can service only one accounting request at a time.<46>

The method GetNextAccountingDataBatch returns data from the accounting database if all the data was not retrieved by previous calls to this method or either of the methods ExecuteAccountingQuery (section 3.2.4.3.3) or GetRawAccountingData (section 3.2.4.3.4). The availability of additional database data is indicated by the value returned in the pbIsThereMoreData parameter of each of these methods.

If ExecuteAccountingQuery or GetRawAccountingData had returned indicating no more accounting data to be retrieved, and still GetNextAccountingDataBatch is called, pbstrResult is returned as NULL.

Additional IWRMAccounting interface methods are specified in section 3.2.4.3.