Método ITLegacyAddressMediaControl::GetID (tapi3if.h)

Artigo
03/13/2024

O método GetID retorna um identificador de dispositivo para a classe de dispositivo especificada associada ao endereço atual.

Esse método destina-se apenas a aplicativos C/C++. Não há nenhum método correspondente disponível para o Visual Basic e aplicativos de script.

Sintaxe

HRESULT GetID(
  [in]  BSTR  pDeviceClass,
  [out] DWORD *pdwSize,
  [out] BYTE  **ppDeviceID
);

Parâmetros

[in] pDeviceClass

Ponteiro para BSTR que contém a classe de dispositivo TAPI para a qual as informações de configuração são necessárias.

[out] pdwSize

Comprimento do identificador do dispositivo retornado.

[out] ppDeviceID

Identificador do dispositivo.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_FAIL	Falha no método. Isso pode significar que não há nenhum dispositivo de uma classe especificada associada ao endereço atual.
E_POINTER	O parâmetro pdwSize ou ppDeviceID não é um ponteiro válido.

Comentários

O aplicativo deve chamar ITTAPI::RegisterCallNotifications antes de chamar esse método.

O aplicativo deve usar SysAllocString para alocar memória para o parâmetro pDeviceClass e usar SysFreeString para liberar a memória quando a variável não for mais necessária.

O aplicativo deve chamar a função CoTaskMemFree para liberar a memória alocada para o parâmetro ppDeviceID .

Referências cruzadas do TAPI 2.1: lineGetDevConfig, lineSetDevConfig, lineGetID