lineSecureCall
The lineSecureCall
function secures the call from any interruptions or interference that may
affect the call's media stream.
LONG lineSecureCall(
|
HCALL hCall |
|
|
); |
|
Parameters
hCall
A handle to
the call to be secured. The application must be an owner of the call. The call
state of hCall can be any state.
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
A call can be
secured to avoid interference. For example, in an analog environment,
call-waiting tones may destroy a fax or modem session on the original call. The
lineSecureCall function allows an existing call to be secured. The lineMakeCall
function provides the option to secure the call from the time of call setup. The
securing of a call remains in effect for the duration of the call.
See Also