Share via


lineSetCallPrivilege

A version of this page is also available for

Windows Embedded CE 6.0 R3

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

See Also

Reference

lineDrop