Driver Library State Control Functions

COS.Init - Initializes variables used by the Driver Library.

This function MUST be called before attempting to use any Driver Library functions.

On Entry:

On Exit: <cosError> is equal to:

NOERROR if initialization is successful

WRONGVERSION if the call is made from a non-windows session.

COS.PushState – Saves the current state the Driver library

This function should be called before initializing and executing a recursed dialog and also before executing any other modal procedure. Basically - this code saves off information about the current dialog so it can be restored after a subsequent dialog is terminated.

On Entry:

On Exit:

COS.PopState - Restores the state of the Driver library

This function is called after terminating a dialog or other dialog-like features, restoring previously saved information (see COS.PushState) about the last dialog executed.

On Entry:

On Exit:

COS.DestroyAll - Destroys all dialogs and maintained by the Driver Library

This function should be called at the end of a program to ensure that all dialogs have been removed.

On Entry:

On Exit: