TSPI_providerFreeDialogInstance

The TSPI_providerFreeDialogInstance function informs the service provider that the dialog box associated with hdDlgInst has exited. After this function is called, the service provider should no longer send data to the dialog box using LINE_SENDDIALOGINSTANCEDATA messages.

Implementation of this function is optional; it is needed only if the service provider generates spontaneous dialog boxes in application contexts using LINE_CREATEDIALOGINSTANCE.

LONG TSPIAPI TSPI_providerFreeDialogInstance(
  HDRVDIALOGINSTANCE hdDlgInst  
); 

Parameters

hdDlgInst

The opaque identifier of the association between the service provider and the dialog box in the application's context, which was passed as the hdDlgInstance member in the TUISPICREATEDIALOGINSTANCEPARAMS structure with the LINE_CREATEDIALOGINSTANCE message that created the dialog box.

Return Values

Returns zero if successful, or one of these negative error values:

LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 SP3 or later.
  Windows 95/98: Requires Windows 95 or later.
  Version: Requires TAPI 2.0 or later.
  Header: Declared in Tspi.h.

See Also

LINE_CREATEDIALOGINSTANCE, LINE_SENDDIALOGINSTANCEDATA, TUISPICREATEDIALOGINSTANCEPARAMS