lineSetCallPrivilege

  • Article

This function sets the application's privilege to the specified privilege.

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 Values

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

OS Versions: Windows CE 1.0 and later.
Header: Tapi.h.
Link Library: Coredll.lib.

See Also

lineDrop

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.