lineRemoveFromConference
The lineRemoveFromConference
function removes the specified call from the conference call to which it
currently belongs. The remaining calls in the conference call are unaffected.
LONG lineRemoveFromConference(
|
HCALL hCall |
|
|
); |
|
Parameters
hCall
A handle to
the call to be removed from the conference. The application must be an owner of
this call. Call state of hCall must be conferenced.
Return Values
Returns a
positive request ID if the function will be completed asynchronously, or a
negative error number if an error has occurred. The dwParam2 parameter
of the corresponding LINE_REPLY
message is zero if the function is successful or it is a negative error number
if an error has occurred. Possible return values are:
LINEERR_INVALCALLHANDLE,
LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED,
LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_NOTOWNER,
LINEERR_UNINITIALIZED.
Remarks
This
operation removes a party that currently belongs to a conference call. After
the call has been successfully removed, it may be possible to further
manipulate it using its handle. The availability of this operation and its
result are likely to be limited in many implementations. For example, in many
implementations, only the most recently added party may be removed from a
conference, and the removed call may be automatically dropped (becomes idle).
Consult the line's device capabilities to determine the available effects of
removing a call from a conference.
If the
removal of a participant from a conference is supported, the participant call,
after it is removed from the conference, will enter the call-state listed in
the dwRemoveFromConfState field in LINEADDRESSCAPS.
See Also