ITLegacyCallMediaControl2::CreateCustomToneObject method (tapi3if.h)
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 |
|---|---|
|
Method succeeded. |
|
The ppCustomTone parameter is not a valid pointer. |
|
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 |