função TSPI_providerFreeDialogInstance (tspi.h)

A função TSPI_providerFreeDialogInstance informa ao provedor de serviços que a caixa de diálogo associada ao hdDlgInst foi encerrada. Depois que essa função é chamada, o provedor de serviços não deve mais enviar dados para a caixa de diálogo usando mensagens LINE_SENDDIALOGINSTANCEDATA .

A implementação dessa função é opcional; ele será necessário somente se o provedor de serviços gerar caixas de diálogo espontâneas em contextos de aplicativo usando LINE_CREATEDIALOGINSTANCE.

Sintaxe

LONG TSPIAPI TSPI_providerFreeDialogInstance(
  HDRVDIALOGINSTANCE hdDlgInst
);

Parâmetros

hdDlgInst

O identificador opaco da associação entre o provedor de serviços e a caixa de diálogo no contexto do aplicativo, que foi passado como o membro hdDlgInstance na estrutura TUISPICREATEDIALOGINSTANCEPARAMS com a mensagem LINE_CREATEDIALOGINSTANCE que criou a caixa de diálogo.

Retornar valor

Retorna zero se tiver êxito ou um destes valores de erro negativos:

LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED.

Requisitos

Confira também

LINE_CREATEDIALOGINSTANCE

LINE_SENDDIALOGINSTANCEDATA

TUISPICREATEDIALOGINSTANCEPARAMS