Función phoneGetIcon (tapi.h)

La función phoneGetIcon permite a una aplicación recuperar un icono específico del dispositivo telefónico de servicio (o específico del proveedor) que se puede mostrar al usuario.

Sintaxis

LONG phoneGetIcon(
  DWORD   dwDeviceID,
  LPCSTR  lpszDeviceClass,
  LPHICON lphIcon
);

Parámetros

dwDeviceID

Identificador del dispositivo telefónico 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 más alto asociado al dispositivo telefónico 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:

PHONEERR_BADDEVICEID, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_OPERATIONFAILED, PHONEERR_INVALDEVICECLASS, PHONEERR_UNINITIALIZED, PHONEERR_NOMEM, PHONEERR_NODEVICE.

Comentarios

La función phoneGetIcon hace que el proveedor devuelva un identificador (en lphIcon) a un recurso de icono (obtenido de LoadIcon) asociado al teléfono especificado. 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 el teléfono abierto.

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 phoneGetID. Por ejemplo, si el teléfono 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/phone", "" o NULL se pueden usar para solicitar el icono del servicio telefónico.

En el caso de las aplicaciones que usan una versión de TAPI 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 genérico de dispositivo telefónico telefónico. En el caso de las aplicaciones que usan TAPI versión 2.0 o posterior, TAPI sustituye el icono de teléfono predeterminado solo si el parámetro lpszDeviceClass es "tapi/phone", "" 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, phoneGetIcon devuelve PHONEERR_INVALDEVICECLASS.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	tapi.h
Library	Tapi32.lib
Archivo DLL	Tapi32.dll

Consulte también

Funciones complementarias del servicio telefónico

Información general de referencia de TAPI 2.2

phoneGetID