função TUISPI_phoneConfigDialog (tspi.h)
A função TUISPI_phoneConfigDialog faz com que o provedor do dispositivo de telefone especificado exiba uma caixa de diálogo modal como uma janela filho do hwndOwner para permitir que o usuário configure parâmetros relacionados ao dispositivo de telefone. Essa função torna a função TSPI_phoneConfigDialog obsoleta na versão 2.0 e posterior (com suporte na versão 1.4 e anterior).
A implementação é opcional.
Sintaxe
LONG TSPIAPI TUISPI_phoneConfigDialog(
TUISPIDLLCALLBACK lpfnUIDLLCallback,
DWORD dwDeviceID,
HWND hwndOwner,
LPCWSTR lpszDeviceClass
);
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 e enviar a configuração atualizada para o provedor de serviços.
dwDeviceID
O dispositivo de telefone a ser configurado.
hwndOwner
Um identificador para uma janela pai na qual a janela da caixa de diálogo deve ser colocada.
lpszDeviceClass
Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que identifica um nome de classe de dispositivo. Essa classe de dispositivo permite que o chamador selecione uma sub-tela específica das informações de configuração aplicáveis a essa classe de dispositivo. Se esse parâmetro for NULL ou uma cadeia de caracteres vazia, a caixa de diálogo de configuração de nível mais alto será selecionada.
Retornar valor
Retornará zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os possíveis valores retornados são os seguintes:
PHONEERR_BADDEVICEID, PHONEERR_NOMEM, PHONEERR_INUSE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPARAM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_RESOURCEUNAVAIL.
Comentários
O parâmetro lpszDeviceClass permite que o aplicativo selecione uma sub-tela específica das informações de configuração aplicáveis à classe de dispositivo na qual o usuário está interessado. As cadeias de caracteres permitidas são iguais às TSPI_phoneGetID.
Por exemplo, se o telefone der suporte à API comm, passar comm/datamodem como lpszDeviceClass fará com que o provedor exiba os parâmetros relacionados especificamente ao Comm (ou, pelo menos, para iniciar no ponto correspondente em uma cadeia de caixas de diálogo de configuração multinível, para que o usuário não precise pesquisar para localizar os parâmetros desejados). O parâmetro szDeviceClass deve ser "tapi/phone", "" ou NULL para fazer com que o provedor exiba a configuração de nível mais alto para o telefone.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |