phoneGetIcon
The
phoneGetIcon function allows an application to retrieve a service phone device-specific
(or provider-specific) icon that can be displayed to the user.
LONG phoneGetIcon(
DWORD dwDeviceID,
|
|
LPCSTR lpszDeviceClass,
|
|
LPHICON lphIcon
|
|
);
|
|
Parameters
dwDeviceID
The phone 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 phone 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:
PHONEERR_BADDEVICEID, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER,
PHONEERR_OPERATIONFAILED, PHONEERR_INVALDEVICECLASS, PHONEERR_UNINITIALIZED,
PHONEERR_NOMEM, PHONEERR_NODEVICE.
Remarks
The
phoneGetIcon causes the provider to return a handle (in
lphIcon) to an icon resource (obtained from
LoadIcon) associated with the specified phone. The icon handle will be 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 phone 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
phoneGetID. For example, if the phone 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/phone", "", or NULL
may be used to request the icon for the phone 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
phone device icon. For applications using API version 0x00020000 or greater,
TAPI substitutes the default phone icon
only if the
lpszDeviceClass parameter is "tapi/phone", "" 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,
phoneGetIcon returns PHONEERR_INVALDEVICECLASS.
See Also
phoneGetID
- Software for developers
-
Delphi Components
.Net Components
Software for Android Developers
- More information resources
-
MegaDetailed.Net
Unix Manual Pages
Delphi Examples
- Databases for Amazon shops developers
-
Amazon Categories Database
Browse Nodes Database