Estrutura TUISPICREATEDIALOGINSTANCEPARAMS (tspi.h)

Define parâmetros para operações de caixa de diálogo TAPI.

Sintaxe

typedef struct tuispicreatedialoginstanceparams_tag {
  DRV_REQUESTID       dwRequestID;
  HDRVDIALOGINSTANCE  hdDlgInst;
  HTAPIDIALOGINSTANCE htDlgInst;
  LPCWSTR             lpszUIDLLName;
  LPVOID              lpParams;
  DWORD               dwSize;
} TUISPICREATEDIALOGINSTANCEPARAMS, *LPTUISPICREATEDIALOGINSTANCEPARAMS;

Membros

dwRequestID

O dwRequestID passado para o provedor de serviços como um parâmetro na função TSPI assíncrona à qual a interface do usuário espontânea está associada. O TAPI usa isso para identificar o aplicativo em cujo contexto a DLL da interface do usuário deve ser carregada e a função TUISPI_providerGenericDialog invocada.

hdDlgInst

O identificador do provedor de serviços para a associação com a instância da caixa de diálogo genérica. Como é possível que várias instâncias da caixa de diálogo genérica sejam abertas no mesmo ou em vários aplicativos, o provedor de serviços deve garantir que seu identificador seja exclusivo dentro do escopo das instâncias existentes dentro do contexto do provedor.

htDlgInst

O TAPI grava nesse membro seu identificador para a associação criada. Esse membro será definido como NULL se a criação da associação falhar, nesse caso, é impossível para o provedor de serviços criar uma caixa de diálogo espontaneamente no contexto do aplicativo de destino. O provedor de serviços deve usar esse identificador em mensagens para enviar dados para a DLL da interface do usuário (LINE_SENDDIALOGINSTANCEDATA).

lpszUIDLLName

Ponteiro para uma cadeia de caracteres terminada em NULL especificando o nome totalmente qualificado da DLL da interface do usuário a ser carregada no contexto do aplicativo.

lpParams

Ponteiro para um bloco de parâmetro privado a ser transmitido para a função TUISPI_providerGenericDialog da DLL da interface do usuário. O provedor de serviços e a DLL da interface do usuário determinam o conteúdo do bloco de parâmetros. A transferência é unidirecional; a DLL da interface do usuário não é capaz de modificar o bloco de parâmetros e retorná-lo ao provedor de serviços. Em geral, esse bloco instrui a DLL da interface do usuário qual caixa de diálogo exibir e contém as informações a serem exibidas (se necessário).

dwSize

O tamanho, em bytes, do bloco de parâmetros.

Requisitos

Confira também

LINE_SENDDIALOGINSTANCEDATA

TUISPI_providerGenericDialog