Compartilhar via


Método ITLegacyCallMediaControl2::CreateCustomToneObject (tapi3if.h)

O método CreateCustomToneObject cria um objeto de tom personalizado a ser usado com o método GenerateCustomTonesByCollection .

Esse método destina-se ao Visual Basic e aos aplicativos de script. Em vez disso, os aplicativos C/C++ devem usar o método GenerateCustomTones .

Sintaxe

HRESULT CreateCustomToneObject(
  [out] ITCustomTone **ppCustomTone
);

Parâmetros

[out] ppCustomTone

Ponteiro para uma interface ITCustomTone .

Retornar valor

Esse método pode retornar um desses valores.

Valor Significado
S_OK
O método foi bem-sucedido.
E_POINTER
O parâmetro ppCustomTone não é um ponteiro válido.
E_OUTOFMEMORY
Não há memória suficiente para alocar o objeto.

Comentários

O TAPI chama o método AddRef na interface ITCustomTone retornada por ITLegacyCallMediaControl2::CreateCustomToneObject. O aplicativo deve chamar o método Release na interface ITCustomTone para liberar recursos associados a ele.

Requisitos

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

Confira também

GenerateCustomTonesByCollection

ITCustomTone

ITLegacyCallMediaControl2