TSPI_phoneSelectExtVersion función (tspi.h)
La función TSPI_phoneSelectExtVersion selecciona la versión de extensión indicada para el dispositivo telefónico indicado. Las solicitudes posteriores funcionan según esa versión de extensión.
Sintaxis
LONG TSPIAPI TSPI_phoneSelectExtVersion(
HDRVPHONE hdPhone,
DWORD dwExtVersion
);
Parámetros
hdPhone
Identificador del teléfono para el que se va a seleccionar una versión de extensión.
dwExtVersion
Versión de extensión que se va a seleccionar. Este número de versión se negocia mediante TSPI_phoneNegotiateExtVersion. El word más significativo es el número de versión principal y word menos significativo es el número de versión secundaria. Llamar a esta función con dwExtVersion de cero cancela la selección actual.
Valor devuelto
Devuelve cero si la función se realiza correctamente o un número de error si se produce un error. Los valores devueltos posibles son los siguientes:
PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_RESOURCEUNAVAIL.
Comentarios
Esta función selecciona la versión de extensión indicada. Aunque es posible que el número de versión indicado se haya negociado correctamente, es posible que se haya seleccionado una versión de extensión diferente mientras tanto, en cuyo caso se produce un error en esta función (se devuelve PHONEERR_INCOMPATIBLEEXTVERSION).
Las operaciones posteriores en el teléfono después de seleccionar una versión de extensión se comportan según esa versión de extensión. Los intentos posteriores de negociar el informe de versión de extensión notifican estrictamente la versión seleccionada o cero (si el intervalo solicitado no incluye la versión seleccionada). Al llamar a este procedimiento con la versión 0 de extensión especial, se cancela la selección actual. El dispositivo vuelve a ser capaz de admitir su gama completa de números de versión de extensión.
TSPI_phoneSelectExtVersion normalmente se llama en dos situaciones: (1) Una aplicación solicitó abrir un teléfono, la aplicación solicitó que se use una versión de extensión determinada y que no se haya seleccionado actualmente ninguna versión de extensión; o (2) la última aplicación que usa una versión de extensión determinada cerró el teléfono y se puede cancelar la selección de la versión de la extensión.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tspi.h |