lineSetCallPrivilege function (tapi.h)
The lineSetCallPrivilege function sets the application's privilege to the specified privilege.
Syntax
LONG lineSetCallPrivilege(
HCALL hCall,
DWORD dwCallPrivilege
);
Parameters
hCall
Handle to the call whose privilege is to be set. The call state of hCall can be any state.
dwCallPrivilege
Required privilege for the specified call. This parameter uses one and only one of the LINECALLPRIVILEGE_ Constants.
Return value
Returns zero if the request succeeds or a negative error number if an error occurs. Possible return values are:
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCALLPRIVILEGE, LINEERR_UNINITIALIZED, LINEERR_NOMEM.
Remarks
If the application is the sole owner of a non-idle call and can change its privilege to monitor, a LINEERR_INVALCALLSTATE error is returned. The application can also first drop the call using lineDrop to make the call transition to the idle state and then change its privilege.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | tapi.h |
| Library | Tapi32.lib |
| DLL | Tapi32.dll |