TSPI_lineGetExtensionID función (tspi.h)
La función TSPI_lineGetExtensionID devuelve el identificador de extensión que admite el proveedor de servicios para el dispositivo de línea indicado.
Sintaxis
LONG TSPIAPI TSPI_lineGetExtensionID(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
LPLINEEXTENSIONID lpExtensionID
);
Parámetros
dwDeviceID
Dispositivo de línea que se va a consultar.
dwTSPIVersion
Número de versión de interfaz que ya se negoció para este dispositivo mediante TSPI_lineNegotiateTSPIVersion. Esta función funciona según la especificación de interfaz en este nivel de versión.
lpExtensionID
Puntero a una estructura de tipo LINEEXTENSIONID. 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. (Por lo tanto, un identificador de extensión válido no puede constar de todos los ceros).
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:
LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL.
Comentarios
TapI llama normalmente a esta función en respuesta a una aplicación que llama a la función lineNegotiateAPIVersion . El resultado devuelto por el proveedor de servicios debe ser adecuado para su uso en una llamada posterior a TSPI_lineNegotiateExtVersion. Un identificador de extensión de todos los ceros no es un identificador de extensión legal, ya que el valor de todos los ceros se usa para indicar que el proveedor de servicios no admite extensiones.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tspi.h |