ITTAPI2::CreateEmptyCollectionObject method (tapi3if.h)

The CreateEmptyCollectionObject method creates an empty collection object. The collection can be filled with ITDetectTone or ITCustomTone objects for use with the DetectTonesByCollection method or the GenerateCustomTonesByCollection method, respectively.

This method is intended for Visual Basic and scripting applications.

Syntax

HRESULT CreateEmptyCollectionObject(
  [out] ITCollection2 **ppCollection
);

Parameters

[out] ppCollection

Pointer to an ITCollection2 interface on the new collection object.

Return value

This method can return one of these values.

Return code Description
S_OK
Method succeeded.
E_POINTER
The ppCollection parameter is not a valid pointer.
E_OUTOFMEMORY
There is not enough memory to allocate the object.

Requirements

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

See also

ITCollection2

ITCustomTone

ITDetectTone

ITTAPI2