INFORMIX
DataBlade API Programmer's Manual
Chapter 12: DataBlade API Function Descriptions
Home Contents Index Master Index New Book

mi_switch_mem_duration()

The mi_switch_mem_duration() function changes the default memory duration for subsequent DataBlade API memory allocations to the specified memory duration.

Syntax

Usage

This function does not change the memory duration for the current allocation.

If the memory duration has been switched from PER_FUNCTION to PER_COMMAND for a particular purpose, you might want to invoke mi_switch_mem_duration() to switch back when PER_COMMAND is no longer required. This action could avoid unnecessary memory consumption.

The mi_switch_mem_duration() function has no effect if it is invoked on the client. The client ignores duration.

Return Values

The previous memory duration.

Related Topics

For additional information, see the descriptions of the following functions: mi_alloc(), mi_dalloc(), mi_free(), and mi_zalloc().




DataBlade API Programmer's Manual, version 9.1
Copyright © 1998, Informix Software, Inc. All rights reserved.