función TSPI_phoneGetExtensionID (tspi.h)
La función TSPI_phoneGetExtensionID recupera el identificador de extensión que el proveedor de servicios admite para el dispositivo telefónico indicado.
Sintaxis
LONG TSPIAPI TSPI_phoneGetExtensionID(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
LPPHONEEXTENSIONID lpExtensionID
);
Parámetros
dwDeviceID
Dispositivo telefónico que se va a consultar.
dwTSPIVersion
Especifica un número de versión de interfaz que se negocia para este dispositivo mediante TSPI_phoneNegotiateTSPIVersion. Esta función funciona según la especificación de interfaz en este nivel de versión.
lpExtensionID
Puntero a una estructura de tipo PHONEEXTENSIONID. Si el proveedor de servicios admite extensiones específicas del proveedor, rellena esta estructura con el identificador de extensión de estas extensiones. Si el proveedor de servicios no admite extensiones, rellena esta estructura con todos los ceros. Un identificador de extensión de todos los ceros no es un identificador de extensión legal, ya que el valor all-zeros se usa para indicar que el proveedor de servicios no admite extensiones.
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:
PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.
Comentarios
Normalmente, TAPI llama a esta función en respuesta a una aplicación que llama a la función phoneNegotiateAPIVersion . El resultado devuelto por el proveedor de servicios debe ser adecuado para su uso en una llamada posterior a TSPI_phoneNegotiateExtVersion.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tspi.h |