Función lineGetIcon (tapi.h)
La función lineGetIcon permite a una aplicación recuperar un icono específico del dispositivo de línea de servicio (o específico del proveedor) para mostrarlo al usuario.
Sintaxis
LONG lineGetIcon(
DWORD dwDeviceID,
LPCSTR lpszDeviceClass,
LPHICON lphIcon
);
Parámetros
dwDeviceID
Identificador del dispositivo de línea cuyo icono se solicita.
lpszDeviceClass
Puntero a una cadena terminada en null que identifica un nombre de clase de dispositivo. Esta clase de dispositivo permite a la aplicación seleccionar un subicono específico aplicable a esa clase de dispositivo. Este parámetro es opcional y se puede dejar NULL o vacío, en cuyo caso se seleccionaría el icono de nivel superior asociado al dispositivo de línea en lugar de un dispositivo de flujo multimedia especificado.
lphIcon
Puntero a una ubicación de memoria en la que se devuelve el identificador al icono.
Valor devuelto
Devuelve cero si la solicitud se realiza correctamente o un número de error negativo si se produce un error. Los valores devueltos posibles son:
LINEERR_BADDEVICEID, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALDEVICECLASS, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_NODEVICE.
Comentarios
La función lineGetIcon hace que el proveedor devuelva un identificador (en lphIcon) a un recurso de icono (obtenido de LoadIcon) asociado a la línea especificada. El identificador de icono es para un recurso asociado al proveedor. La aplicación debe usar CopyIcon si quiere hacer referencia al icono después de descargar el proveedor, lo que es poco probable que suceda siempre que la aplicación tenga abierta la línea.
El parámetro lpszDeviceClass permite al proveedor devolver iconos diferentes en función del tipo de servicio al que hace referencia el autor de la llamada. Las cadenas permitidas son las mismas que para lineGetID. Por ejemplo, si la línea admite comm API, pasar "COMM" como lpszDeviceClass hace que el proveedor devuelva un icono relacionado específicamente con las funciones de dispositivo Comm del proveedor de servicios. Los parámetros "tapi/line", "" o NULL se pueden usar para solicitar el icono del servicio de línea.
En el caso de las aplicaciones que usan una versión de API anterior a la 2.0, si el proveedor no devuelve un icono (ya sea porque la clase de dispositivo especificada no es válida o el proveedor no admite iconos), TAPI sustituye un icono de dispositivo de línea de telefonía genérico. En el caso de las aplicaciones que usan la versión 2.0 o posterior de la API, TAPI sustituye el icono de línea predeterminado solo si el parámetro lpszDeviceClass es "tapi/line", "" o NULL. Para cualquier otra clase de dispositivo, si la clase de dispositivo especificada no es válida o el proveedor no admite iconos para la clase, lineGetIcon devuelve LINEERR_INVALDEVICECLASS.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tapi.h |
| Library | Tapi32.lib |
| Archivo DLL | Tapi32.dll |
Consulte también
Referencia básica de servicios de telefonía