função TUISPI_providerGenericDialogData (tspi.h)
A função TUISPI_providerGenericDialogData na DLL da interface do usuário é chamada quando o provedor de serviços envia uma mensagem LINE_SENDDIALOGINSTANCEDATA . O provedor de serviços usa isso para atualizar espontaneamente as informações em caixas de diálogo criadas no contexto do aplicativo em conjunto com o processamento de funções TSPI assíncronas específicas. Essa função é chamada de um thread separado daquele no qual TUISPI_providerGenericDialogData está em execução. A DLL da interface do usuário não deve bloquear o thread no qual essa função é chamada, mas deve processar os dados e retornar imediatamente (postando uma mensagem na caixa de diálogo, se necessário).
A implementação será obrigatória se TUISPI_providerGenericDialog for exportado.
Sintaxe
LONG TSPIAPI TUISPI_providerGenericDialogData(
HTAPIDIALOGINSTANCE htDlgInst,
LPVOID lpParams,
DWORD dwSize
);
Parâmetros
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.
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. Se esse parâmetro for definido como NULL, essa será uma solicitação para fechar a caixa de diálogo imediatamente e limpo para cima ( TUISPIDLLCALLBACK não deve ser invocado durante essa limpeza). O TAPI invoca essa função com lpParams definidos como NULL para forçar a limpeza da caixa de diálogo em determinadas circunstâncias, como um aplicativo chamando lineShutdown com uma caixa de diálogo ainda ativa.
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 .
Retornar valor
Retorna zero se tiver êxito ou um destes valores de erro negativos:
LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |