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

Artigo
08/26/2023

O método GetID obtém o identificador do dispositivo associado à chamada atual.

Esse método destina-se a aplicativos C/C++. O Visual Basic e os aplicativos de script devem usar o método ITLegacyCallMediaControl2::GetIDAsVariant .

Sintaxe

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

Parâmetros

[in] pDeviceClass

Ponteiro para BSTR que representa a classe de dispositivo TAPI.

[out] pdwSize

Tamanho em bytes do identificador do dispositivo.

[out] ppDeviceID

Identificador do dispositivo.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_OUTOFMEMORY	Há memória insuficiente para executar a operação.
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 .