Método ITLegacyAddressMediaControl2::ConfigDialogEdit (tapi3if.h)

O método ConfigDialogEdit faz com que o provedor do dispositivo de linha especificado exiba uma caixa de diálogo para permitir que o usuário configure parâmetros relacionados ao dispositivo de linha. Os dados de configuração são passados dentro e fora desse método pelo aplicativo. (Os dados são os mesmos recuperados pelo método ITLegacyAddressMediaControl::GetDevConfig e definidos pelo método ITLegacyAddressMediaControl::SetDevConfig .)

Sintaxe

HRESULT ConfigDialogEdit(
  [in]  HWND  hwndOwner,
  [in]  BSTR  pDeviceClass,
  [in]  DWORD dwSizeIn,
  [in]  BYTE  *pDeviceConfigIn,
  [out] DWORD *pdwSizeOut,
  [out] BYTE  **ppDeviceConfigOut
);

Parâmetros

[in] hwndOwner

Um identificador para uma janela à qual a caixa de diálogo deve ser anexada. Pode ser NULL para indicar que uma janela criada pelo método não deve ter nenhuma janela de proprietário.

[in] pDeviceClass

Ponteiro para um BSTR que especifica 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.

[in] dwSizeIn

Ponteiro para o tamanho dos dados de configuração apontados pelo parâmetro pDeviceConfigIn .

[in] pDeviceConfigIn

Ponteiro para uma matriz de bytes que contém dados de configuração do dispositivo a serem editados.

[out] pdwSizeOut

Ponteiro para o tamanho dos dados de configuração apontados pelo parâmetro ppDeviceConfigOut .

[out] ppDeviceConfigOut

Ponteiro para uma matriz de bytes que contém dados de configuração de dispositivo editados.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Esse método é convertido em um TAPI 2. xlineConfigDialogEdit call. O método ITLegacyAddressMediaControl2::ConfigDialog é convertido em uma chamada lineConfigDialog . Esses métodos diferem em sua origem de parâmetros para editar e o resultado da edição em uma conexão ativa. Para obter uma discussão sobre essas diferenças, consulte lineConfigDialogEdit.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	tapi3if.h
Biblioteca	Uuid.lib
DLL	Tapi3.dll

Confira também

ITLegacyAddressMediaControl2

ITLegacyAddressMediaControl2::ConfigDialog