función TSPI_providerFreeDialogInstance (tspi.h)

La función TSPI_providerFreeDialogInstance informa al proveedor de servicios de que se ha cerrado el cuadro de diálogo asociado a hdDlgInst . Después de llamar a esta función, el proveedor de servicios ya no debe enviar datos al cuadro de diálogo mediante LINE_SENDDIALOGINSTANCEDATA mensajes.

La implementación de esta función es opcional; solo es necesario si el proveedor de servicios genera cuadros de diálogo espontáneas en contextos de aplicación mediante LINE_CREATEDIALOGINSTANCE.

Sintaxis

LONG TSPIAPI TSPI_providerFreeDialogInstance(
  HDRVDIALOGINSTANCE hdDlgInst
);

Parámetros

hdDlgInst

Identificador opaco de la asociación entre el proveedor de servicios y el cuadro de diálogo en el contexto de la aplicación, que se pasó como miembro hdDlgInstance en la estructura TUISPICREATEDIALOGINSTANCEPARAMS con el mensaje LINE_CREATEDIALOGINSTANCE que creó el cuadro de diálogo.

Valor devuelto

Devuelve cero si se ejecuta correctamente o uno de estos valores de error negativos:

LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED.

Requisitos

Consulte también

LINE_CREATEDIALOGINSTANCE

LINE_SENDDIALOGINSTANCEDATA

TUISPICREATEDIALOGINSTANCEPARAMS