função TSPI_phoneConfigDialog (tspi.h)
A função TSPI_phoneConfigDialog está obsoleta. Os provedores de serviços TAPI versão 1.4 ou anteriores podem implementar essa função TSPI. Os TSPs tapi versão 2.0 ou posterior implementam TUISPI_phoneConfigDialog.
A função TSPI_phoneConfigDialog faz com que o provedor do dispositivo de telefone especificado exiba uma caixa de diálogo modal como uma janela filho de hwndOwner para permitir que o usuário configure parâmetros relacionados ao dispositivo de telefone.
Sintaxe
LONG TSPIAPI TSPI_phoneConfigDialog(
DWORD dwDeviceID,
HWND hwndOwner,
LPCSTR lpszDeviceClass
);
Parâmetros
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 subtela específica de 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 valores retornados possíveis são os seguintes:
PHONEERR_BADDEVICEID, PHONEERR_NOMEM, PHONEERR_INUSE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPARAM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_RESOURCEUNAVAIL.
Comentários
TSPI_phoneConfigDialog faz com que o provedor de serviços exiba uma caixa de diálogo modal como uma janela filho de hWndOwner para permitir que o usuário configure parâmetros relacionados ao telefone especificado por dwDeviceID. O parâmetro lpszDeviceClass permite que o aplicativo selecione uma subtela específica de informações de configuração aplicáveis à classe de dispositivo na qual o usuário está interessado. As cadeias de caracteres permitidas são as mesmas de 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 caixa de diálogo de configuração de vários níveis, 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.
O procedimento deve atualizar a seção [Telefonia do Windows] no arquivo Win.ini e transmitir a mensagem WM_WININICHANGE se fizer alterações em Telephon.ini que afetem o conteúdo das estruturas visíveis para aplicativos (como PHONECAPS) ou se os dispositivos de telefone forem criados ou removidos.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tspi.h |