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

Información general de referencia de TAPI 2.2

lineGetID