función TSPI_lineGetIcon (tspi.h)
La función TSPI_lineGetIcon recupera un icono específico del dispositivo de línea de servicio que se mostrará al usuario.
Sintaxis
LONG TSPIAPI TSPI_lineGetIcon(
DWORD dwDeviceID,
LPCWSTR lpszDeviceClass,
LPHICON lphIcon
);
Parámetros
dwDeviceID
Dispositivo de línea cuyo icono se solicita.
lpszDeviceClass
Puntero a una cadena Unicode terminada en null que identifica un nombre de clase de dispositivo. Esta clase de dispositivo permite al autor de la llamada seleccionar un icono específico de esa clase de dispositivo. Este parámetro es opcional y se puede dejar NULL, en cuyo caso se selecciona el icono de nivel más alto asociado al dispositivo de línea en lugar de un dispositivo de secuencia multimedia especificado.
Las cadenas permitidas son las mismas que para TSPI_lineGetID. Por ejemplo, si la línea admite comm API, pasar comm/datamodem como lpszDeviceClass hace que el proveedor devuelva un icono relacionado específicamente con las funciones de dispositivo Comm del proveedor de servicios.
lphIcon
Puntero a una ubicación de memoria en la que se devuelve el identificador al icono.
Valor devuelto
Devuelve cero si la función se ejecuta correctamente o un número de error si se produce un error. Los valores devueltos posibles son los siguientes:
LINEERR_INVALDEVICECLASS, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_OPERATIONUNAVAIL.
Comentarios
El proveedor debe devolver un identificador (en el DWORD al que apunta lphIcon) a un recurso de icono (obtenido del
Función LoadIcon ) asociada a la línea especificada.
Un proveedor puede optar por admitir muchos iconos (seleccionados por lpszDeviceClass o número de línea), un único icono (por ejemplo, para el fabricante, que se devolvería para todas las solicitudes de TSPI_lineGetIcon independientemente de la lpszDeviceClass seleccionada) o ningún icono, en cuyo caso establece el DWORD al que apunta lphIcon en NULL. TAPI examina el identificador devuelto por el proveedor y, si el proveedor devuelve NULL, TAPI sustituye un icono genérico de telefonía (el icono de "línea" genérico).
Requisitos
| Plataforma de destino | Windows |
| Encabezado | tspi.h |