Share via

lineSetCallPrivilege

  • Article

The lineSetCallPrivilege function sets the application's privilege to the specified privilege.

LONG WINAPI lineSetCallPrivilege(
HCALL hcall, 
DWORD dwCallPrivilege);

Parameters

  • hCall
    A handle to the call whose privilege is to be set. The call state of hCall can be any state.
  • dwCallPrivilege
    The privilege the application can have for the specified call. This parameter uses one and only one of the LINECALLPRIVILEGE_Constants.

Return Values

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 the lineDrop function to make the call transition to the idle state and then change its privilege.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Tapi.h   Coredll.lib

See Also

lineDrop

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.