lineSetCallPrivilege
A version of this page is also available for
4/8/2010
This function sets the application's privilege to the specified privilege.
Syntax
LONG WINAPI 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
Privilege the application can have for the specified call. This parameter uses one and only one of the LINECALLPRIVILEGE.
Return Value
Zero indicates success. A negative error number indicates that an error occurred. The following table shows the return values for this function.
Value | Description |
---|---|
LINEERR_INVALCALLHANDLE |
The call handle is invalid. |
LINEERR_INVALCALLSTATE |
The application is the sole owner of a non-idle call and can change its privilege to monitor |
LINEERR_INVALCALLPRIVILEGE |
The call privilege is invalid. |
LINEERR_NOMEM |
Not enough memory is available. |
LINEERR_OPERATIONFAILED |
The operation failed. |
LINEERR_RESOURCEUNAVAIL |
The resource is unavailable. |
LINEERR_UNINITIALIZED |
The parameter is unitinialized. |
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 the lineDrop function to make the call transition to the idle state and then change its privilege.
Requirements
Header | tapi.h |
Library | coredll.lib |
Windows Embedded CE | Windows CE 1.0 and later |
Windows Mobile | Windows Mobile Version 5.0 and later |