|
lineGetConfRelatedCalls
The lineGetConfRelatedCalls function returns a list of call handles that are part of the same conference
call as the specified call. The specified call is either a conference call or a
participant call in a conference call. New handles are generated for those
calls for which the application does not already have handles, and the application
is granted monitor privilege to those calls.
LONG lineGetConfRelatedCalls(
HCALL hCall,
|
| LPLINECALLLIST lpCallList
|
| );
|
|
Parameters
hCall
A handle to a call. This is either a conference call or a participant call in
a conference call. For a conference parent call, the call state of hCall can be any state. For a conference participant call, it must be in the conferenced state.
lpCallList
A pointer to a variably sized data structure of type LINECALLLIST. Upon successful completion of the request, call handles to all calls in the
conference call are returned in this structure. The first call in the list is
the conference call, the other calls are the participant calls. The application
is granted monitor privilege to those calls for which it does not already have
handles; the privileges to calls in the list for which the application already
has handles is unchanged. Prior to calling lineGetConfRelatedCalls, the application should set the dwTotalSize field of this structure to indicate the amount of memory available to TAPI
for returning information.
Return Values
Returns zero if the request is successful or a negative error number if an
error has occurred. Possible return values are:
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOCONFERENCE,
LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL,
LINEERR_NOMEM, LINEERR_UNINITIALIZED.
Remarks
The specified call can either be a conference call handle or a handle to a
participant call. For example, a consultation call that has not yet been added to
a conference call is not part of a conference. The first entry in the list that
is returned is the conference call handle, the other handles are all the
participant calls. The specified call is always one of the calls returned in the
list. Calls in the list to which the application does not already have a call
handle are assigned monitor privilege; privileges to calls for which the
application already has handles are unchanged. The application can use lineSetCallPrivilege to change the privilege of the call.
Note that if lineGetConfRelatedCalls is called immediately after a call is added to a conference using lineCompleteTransfer, lineGetConfRelatedCalls may not return a complete list of related calls because TAPI waits to receive
a LINE_CALLSTATE message indicating that the call has entered
LINECALLSTATE_CONFERENCED before it considers the call to actually be part of the conference
(that is, the conferenced state is confirmed by the service provider). Once the application has
received the LINE_CALLSTATE message, lineGetConfRelatedCalls returns complete information.
The application can invoke lineGetCallInfo and lineGetCallStatus for each call in the list to determine the call's information and status,
respectively.
See Also
LINE_CALLSTATE, lineCompleteTransfer, lineGetCallInfo, lineGetCallStatus, lineSetCallPrivilege
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
More Online Helps
Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Unix Manual Pages
|
