Ns_DbFlush

Overview

Flush any waiting rows

Syntax

    int Ns_DbFlush(
    	Ns_DbHandle *handle
    );

Description

The Ns_DbFlush function fetches and dumps any waiting rows after an Ns_DbSelect. This function is useful when you have already fetched all the rows you intend to process. Ns_DbFlush returns NS_OK after successfully flushing the database or NS_ERROR on error.

Ns_DbFlush is called automatically when Ns_DbHandle's are returned to their pools with the Ns_DbPutHandle function to make sure the handle is ready the next time it is used.

Some database drivers (for example, the Illustra driver), will also cancel any active transactions when Ns_DbFlush is called.