|
lineGetIcon
The lineGetIcon function allows an application to retrieve a service line device-specific (or
provider-specific) icon for display to the user.
LONG lineGetIcon(
DWORD dwDeviceID,
|
| LPCSTR lpszDeviceClass,
|
| LPHICON lphIcon
|
| );
|
|
Parameters
dwDeviceID
The line device whose icon is requested.
lpszDeviceClass
A pointer to a NULL-terminated string that identifies a device class name.
This device class allows the application to select a specific sub-icon applicable
to that device class. This parameter is optional and can be left NULL or empty,
in which case the highest-level icon associated with the line device rather
than a specified media stream device would be selected.
lphIcon
A pointer to a memory location in which the handle to the icon is returned.
Return Values
Returns zero if the request is successful or a negative error number if an
error has occurred. Possible return values are:
LINEERR_BADDEVICEID, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER,
LINEERR_RESOURCEUNAVAIL, LINEERR_INVALDEVICECLASS, LINEERR_UNINITIALIZED, LINEERR_NOMEM,
LINEERR_NODEVICE.
Remarks
The lineGetIcon function causes the provider to return a handle (in lphIcon) to an icon resource (obtained from LoadIcon) that is associated with the specified line. The icon handle is for a
resource associated with the provider. The application must use CopyIcon if it wishes to reference the icon after the provider is unloaded, which is
unlikely to happen as long as the application has the line open.
The lpszDeviceClass parameter allows the provider to return different icons based on the type of
service being referenced by the caller. The permitted strings are the same as
for lineGetID. For example, if the line supports the Comm API, passing "COMM" as lpszDeviceClass causes the provider to return an icon related specifically to the Comm device
functions of the service provider. The parameters "tapi/line", "", or NULL may
be used to request the icon for the line service.
For applications using an API version less than 0x00020000, if the provider
does not return an icon (whether because the given device class is invalid or the
provider does not support icons), TAPI substitutes a generic Win32 Telephony
line device icon. For applications using API version 0x00020000 or greater, TAPI
substitutes the default line icon only if the lpszDeviceClass parameter is "tapi/line", "" or NULL. For any other device class, if the
given device class is not valid or the provider does not support icons for the
class, lineGetIcon returns LINEERR_INVALDEVICECLASS.
See Also
lineGetID
| Last news from Greatis Software |
 |
|
Nostalgia .Net |
|
.Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More » |
| Recommended software for developers |
 |
|
Ultimate Pack |
|
Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More » |
 |
|
Form Designer .Net |
|
Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More » |
 |
|
Print Suite .Net |
|
Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More » |
 |
|
Gradient Controls .Net |
|
Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More » |
 |
|
Greatis iGrid |
|
iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More » |
All the contacts and projectsDmitry Vasiliev (just.dmitry)
Related LinksSoftware for Visual Studio .NET developers
Software for Delphi and C++ Builder developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages
|
