função TUISPI_providerGenericDialog (tspi.h)

Artigo
08/26/2023

A função TUISPI_providerGenericDialog na DLL da interface do usuário é chamada quando o provedor de serviços envia uma mensagem LINE_CREATEDIALOGINSTANCE . O provedor de serviços usa isso para criar caixas de diálogo no contexto do aplicativo em conjunto com o processamento de funções TSPI assíncronas específicas. Essa função é chamada de um thread criado especificamente para exibir a caixa de diálogo. A DLL da interface do usuário não retorna dessa função até que a caixa de diálogo seja destruída.

A implementação será obrigatória se o provedor de serviços associado à DLL da interface do usuário enviar mensagens LINE_CREATEDIALOGINSTANCE para criar caixas de diálogo espontaneamente no contexto do aplicativo.

Sintaxe

LONG TSPIAPI TUISPI_providerGenericDialog(
  TUISPIDLLCALLBACK   lpfnUIDLLCallback,
  HTAPIDIALOGINSTANCE htDlgInst,
  LPVOID              lpParams,
  DWORD               dwSize,
  HANDLE              hEvent
);

Parâmetros

lpfnUIDLLCallback

Ponteiro para uma função que a DLL da interface do usuário pode chamar para se comunicar com a DLL do provedor de serviços para obter as informações necessárias para exibir a caixa de diálogo.

htDlgInst

O identificador opaco que associa a associação dessa instância da função a uma solicitação específica do provedor de serviços. A DLL da interface do usuário deve incluir esse parâmetro, juntamente com TUISPI_OBJECT_DIALOGINSTANCE, em qualquer chamada a TUISPIDLLCALLBACK para solicitar mais dados ou fornecer dados ao provedor de serviços.

lpParams

Ponteiro para uma área de memória usada para manter um bloco de parâmetros. O conteúdo desse bloco de parâmetros é específico para o provedor de serviços e sua DLL de interface do usuário associada. O transporte de dados por meio desse bloco de parâmetros é unidirecional para a DLL da interface do usuário; as alterações feitas no bloco de parâmetros não são refletidas novamente no provedor de serviços. Em geral, esse bloco de parâmetro contém todas as informações que a DLL da interface do usuário precisa para exibir inicialmente a caixa de diálogo.

dwSize

O tamanho em bytes do bloco de parâmetros. Se o parâmetro lpParams for um ponteiro para uma cadeia de caracteres, o tamanho deverá incluir o terminador nulo .

hEvent

Manipule para um objeto de evento criado pelo TAPI. Esse evento é sinalizado pela DLL da interface do usuário por meio de SetEvent (hEvent) quando a DLL da interface do usuário conclui a inicialização dessa instância da caixa de diálogo e está preparada para receber dados adicionais da caixa de diálogo por meio de TUISPI_providerGenericDialogData. Os dados enviados pelo provedor de serviços associado (por meio de LINE_SENDDIALOGINSTANCEDATA) para essa instância da caixa de diálogo são bloqueados pela TAPI até que a DLL da interface do usuário sinalize esse evento, dando a TUISPI_providerGenericDialog a oportunidade de executar qualquer inicialização necessária. A DLL da interface do usuário deve sinalizar o evento o mais rápido possível para evitar o bloqueio de chamadas para TUISPI_providerGenericDialogData.