Compartilhar via


função TSPI_providerGenericDialogData (tspi.h)

A função TSPI_providerGenericDialogData fornece aos dados do provedor de serviços que foram enviados da DLL da interface do usuário em execução em um contexto de aplicativo por meio da função TUISPIDLLCALLBACK . O conteúdo do bloco de memória apontado por lpParams é 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, a TAPI copia os dados modificados de volta para o bloco de parâmetros de DLL da interface do usuário original.

A implementação será obrigatória se a DLL da interface do usuário associada ao provedor de serviços chamar TUISPIDLLCALLBACK.

Sintaxe

LONG TSPIAPI TSPI_providerGenericDialogData(
  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

dwObjectID é um identificador de dispositivo de linha (dwDeviceID).

TUISPIDLL_OBJECT_PHONEID

dwObjectID é um identificador de dispositivo de telefone (dwDeviceID)

TUISPIDLL_OBJECT_PROVIDERID

dwObjectID é um identificador de provedor permanente.

TUISPIDLL_OBJECT_DIALOGINSTANCE

dwObjectID é um HDRVDIALOGINSTANCE, conforme retornado ao provedor de serviços quando ele enviou uma mensagem LINE_CREATEDIALOGINSTANCE .

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.

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 .

Valor retornado

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

LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho tspi.h

Confira também

LINE_CREATEDIALOGINSTANCE

TUISPIDLLCALLBACK