ITLegacyCallMediaControl2::CreateCustomToneObject method (tapi3if.h)

Article
02/22/2024

The CreateCustomToneObject method creates a custom tone object to use with the GenerateCustomTonesByCollection method.

This method is intended for Visual Basic and scripting applications. C/C++ applications should use the GenerateCustomTones method instead.

Syntax

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

Parameters

[out] ppCustomTone

Pointer to an ITCustomTone interface.

Return value

This method can return one of these values.

Value	Meaning
S_OK	Method succeeded.
E_POINTER	The ppCustomTone parameter is not a valid pointer.
E_OUTOFMEMORY	There is not enough memory to allocate the object.

Remarks

TAPI calls the AddRef method on the ITCustomTone interface returned by ITLegacyCallMediaControl2::CreateCustomToneObject. The application must call the Release method on the ITCustomTone interface to free resources associated with it.

Requirements

Requirement	Value
Target Platform	Windows
Header	tapi3if.h
Library	Uuid.lib
DLL	Tapi3.dll