Função de retorno de chamada TUISPIDLLCALLBACK (tspi.h)

Artigo
08/26/2023

A função DllCallbackProc é chamada pela DLL da interface do usuário para enviar um bloco de parâmetro privado para o provedor de serviços. Cada invocação do retorno de chamada resulta em uma chamada para a função TSPI_providerGenericDialogData no provedor de serviços associado ao objeto especificado. O conteúdo do bloco de parâmetros é definido pelo provedor de serviços e pela DLL da interface do usuário. O provedor de serviços pode modificar o conteúdo do bloco de parâmetros; quando essa função retorna, o TAPI copia os dados modificados de volta para o bloco de parâmetros de DLL da interface do usuário original.

O tipo TUISPIDLLCALLBACK define um ponteiro para essa função de retorno de chamada. DllCallbackProc é um espaço reservado para o nome da função definida pelo aplicativo.

Sintaxe

TUISPIDLLCALLBACK Tuispidllcallback;

LONG Tuispidllcallback(
  DWORD_PTR dwObjectID,
  DWORD dwObjectType,
  LPVOID lpParams,
  DWORD dwSize
)
{...}

Parâmetros

dwObjectID

Um identificador de objeto do tipo especificado por dwObjectType.

dwObjectType

Uma das constantes TUISPIDLL_OBJECT_ , especificando o tipo de objeto identificado por dwObjectID

TUISPIDLL_OBJECT_LINEID

O parâmetro dwObjectID é um identificador de dispositivo de linha (dwDeviceID). Isso é usado quando o retorno de chamada é invocado durante o processamento de TUISPI_lineConfigDialog ou TUISPI_lineConfigDialogEdit.

TUISPIDLL_OBJECT_PHONEID

O parâmetro dwObjectID é um identificador de dispositivo de telefone (dwDeviceID). Isso é usado quando o retorno de chamada é invocado durante o processamento de TUISPI_phoneConfigDialog.

TUISPIDLL_OBJECT_PROVIDERID

O parâmetro dwObjectID é um identificador de provedor permanente. Isso é usado quando o retorno de chamada é invocado durante o processamento de TUISPI_providerConfig, TUISPI_providerInstall ou TUISPI_providerRemove.

TUISPIDLL_OBJECT_DIALOGINSTANCE

O parâmetro dwObjectID é um HDRVDIALOGINSTANCE, conforme retornado ao provedor de serviços quando ele enviou uma mensagem de LINE_CREATEDIALOGINSTANCE . Isso é usado quando o retorno de chamada é invocado durante o processamento de TUISPI_providerGenericDialog.

lpParams

Ponteiro para uma área de memória usada para manter um bloco de parâmetros.

dwSize

O tamanho em bytes do bloco de parâmetros.

Nota Se os parâmetros de tamanho na estrutura não estiverem corretos, há a possibilidade de que os dados possam ser substituídos. Para obter mais informações sobre como definir tamanhos de estrutura, consulte o tópico de alocação de memória .