|
lineSetCallPrivilege
The lineSetCallPrivilege function sets the application's privilege to the specified privilege.
LONG 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 wants to have for the specified call. Only a
single flag can be set. This parameter uses the following LINECALLPRIVILEGE_
constants:
LINECALLPRIVILEGE_MONITOR
The application requests monitor privilege to the call. These privileges allow
the application to monitor state changes and to query information and status
about the call.
LINECALLPRIVILEGE_OWNER
The application requests owner privilege to the call. These privileges allow
the application to manipulate the call in ways that affect the state of the
call.
Return Values
Returns zero if the request is successful or a negative error number if an
error has occurred. 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 wants to change
its privilege to monitor, a LINEERR_INVALCALLSTATE error is returned. If the
application wants to, it can first drop the call using lineDrop to make the call transition to the idle state and then change its privilege.
See Also
lineDrop
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
More Online Helps
Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Unix Manual Pages
|
