Função phoneConfigDialog (tapi.h)

Artigo
03/09/2024

A função phoneConfigDialog faz com que o provedor do dispositivo de telefone especificado exiba uma caixa de diálogo modal (anexada ao parâmetro hwndOwner do aplicativo) que permite que o usuário configure parâmetros relacionados ao dispositivo de telefone especificado por dwDeviceID.

Sintaxe

LONG phoneConfigDialog(
  DWORD  dwDeviceID,
  HWND   hwndOwner,
  LPCSTR lpszDeviceClass
);

Parâmetros

dwDeviceID

Identificador do dispositivo de telefone a ser configurado.

hwndOwner

Identificador para uma janela à qual a caixa de diálogo deve ser anexada. Pode ser um valor 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:

PHONEERR_BADDEVICEID, PHONEERR_NOMEM, PHONEERR_INUSE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPARAM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_UNINITIALIZED, PHONEERR_NODEVICE.

Comentários

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 do phoneGetID. Por exemplo, se o telefone der suporte à API de onda, passar "wave/in" como lpszDeviceClass fará com que o provedor exiba os parâmetros relacionados especificamente à onda (ou pelo menos para iniciar no ponto correspondente em uma cadeia de caixa de diálogo de configuração de vários níveis, eliminando a necessidade de pesquisar parâmetros relevantes).

O parâmetro lpszDeviceClass deve ser "tapi/phone", "" ou NULL para fazer com que o provedor exiba a configuração de nível mais alto para o telefone.