PA_GetHandleState


version 2003


PA_GetHandleState (handle) → char

Parameter Type Description
handle PA_Handle The handle
Function result char state of the handle

Description

The PA_GetHandleState command return the state of the handle. Because 4D Memory manager has no incremental locking system, it is better to read the state of the handle, lock it, and restore the previous state. In this case, if the handle was previously locked, it stays locked.

Examples

Read the state of the handle, lock it, and restore the previous state.

   char state = PA_GetHandleState( h );
   pt = PA_Lock( h );
   /* do something with the locked handle */
   PA_SetHandleState( h, state );

See Also

PA_LockHandle , PA_SetHandleState , PA_UnlockHandle .