VioDestroyPS

Description

Destroys the VIO presentation space.

Syntax

#define INCL_VIO
#include <os2.h>

HVIO      hvps;  /*  VIO presentation-space handle. */
APIRET    rc;    /*  Return code. */

rc = VioDestroyPS(hvps);

Parameters

hvps (HVIO) - input

VIO presentation-space handle.

This is a value returned by VioCreatePS.

Return Code

rc (APIRET) - returns

VioDestroyPS returns one of the following values:

• 0 NO_ERROR
• 421 ERROR_VIO_INVALID_PARMS
• 436 ERROR_VIO_INVALID_HANDLE
• 499 ERROR_VIO_ASSOCIATED_DC

Remarks

The presentation space must not be associated with a device context when VioDestroyPS is called.

The VIO presentation-space handle is invalid after this call.

After this call, the local ID for the font is available for reuse.