función TSPI_phoneGetExtensionID (tspi.h)

  • Artículo

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

Consulte también

PHONEEXTENSIONID

TSPI_phoneNegotiateExtVersion

TSPI_phoneNegotiateTSPIVersion