ReleaseDialog

The ReleaseDialog function frees all memory associated with the custom dialog identified in szDialogName. Call this function after calling EndDialog. Call this function outside the message-handling case statement.

Syntax

ReleaseDialog ( szDialogName );

Parameters

ReleaseDialog Parameters

Parameter

Description

szDialogName

Specifies the name of the dialog to destroy.

Return Values

ReleaseDialog Return Values

Return Value

Description

0

Indicates that the function successfully freed all memory associated with the custom dialog.

DLG_ERR (-1)

Function failed. The dialog name may be invalid.

DLG_ERR_ENDDLG (-2)

ReleaseDialog was called before EndDialog. You must call EndDialog first to remove the dialog.