Função lineConfigDialogA (tapi.h)
A função lineConfigDialog faz com que o provedor do dispositivo de linha especificado exiba uma caixa de diálogo (anexada a hwndOwner do aplicativo) para permitir que o usuário configure parâmetros relacionados ao dispositivo de linha.
Sintaxe
LONG lineConfigDialogA(
DWORD dwDeviceID,
HWND hwndOwner,
LPCSTR lpszDeviceClass
);
Parâmetros
dwDeviceID
Identificador do dispositivo de linha a ser configurado.
hwndOwner
Identificador para uma janela à qual a caixa de diálogo deve ser anexada. Pode ser NULL para indicar que qualquer janela criada durante a função não deve ter nenhuma janela de proprietário.
lpszDeviceClass
Ponteiro para uma cadeia de caracteres terminada em nulo que identifica um nome de classe de dispositivo. Essa classe de dispositivo permite que o aplicativo selecione uma subtela específica de informações de configuração aplicáveis a essa classe de dispositivo. Esse parâmetro é opcional e pode ser deixado NULL ou vazio; nesse caso, a configuração de nível mais alto é selecionada.
Retornar valor
Retornará zero se a solicitação for bem-sucedida ou um número de erro negativo se ocorrer um erro. Os valores retornados possíveis são:
LINEERR_BADDEVICEID, LINEERR_NOMEM, LINEERR_INUSE, LINEERR_OPERATIONFAILED, LINEERR_INVALDEVICECLASS, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPARAM, LINEERR_UNINITIALIZED, LINEERR_INVALPOINTER, LINEERR_OPERATIONUNAVAIL, LINEERR_NODEVICE.
Comentários
A função lineConfigDialog faz com que o provedor de serviços exiba uma caixa de diálogo modal (anexada a hwndOwner do aplicativo) para permitir que o usuário configure parâmetros relacionados à linha especificada 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 que para lineGetID. Por exemplo, se a linha der suporte à API comm, passar "COMM" como lpszDeviceClass fará com que o provedor exiba os parâmetros relacionados especificamente ao Comm (ou, pelo menos, comece 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 "cavar" para localizar os parâmetros de interesse).
O parâmetro lpszDeviceClass seria "tapi/line" , "" ou NULL para fazer com que o provedor exiba a configuração de nível mais alto para a linha.
Observação
O cabeçalho tapi.h define lineConfigDialog como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tapi.h |
| Biblioteca | Tapi32.lib |
| DLL | Tapi32.dll |
Confira também
Referência básica dos Serviços de Telefonia