funzione TSPI_lineSelectExtVersion (tspi.h)

La funzione TSPI_lineSelectExtVersion seleziona la versione dell'estensione indicata per il dispositivo linea indicato. Le richieste successive operano in base a tale versione dell'estensione.

Sintassi

LONG TSPIAPI TSPI_lineSelectExtVersion(
  HDRVLINE hdLine,
  DWORD    dwExtVersion
);

Parametri

hdLine

Handle della riga per la quale deve essere selezionata una versione dell'estensione.

dwExtVersion

Versione dell'estensione da selezionare. Questo numero di versione è stato negoziato tramite TSPI_lineNegotiateExtVersion. Word più significativo è il numero di versione principale e il meno significativo word è il numero di versione secondario. La chiamata a questa funzione con dwExtVersion pari a zero annulla la selezione corrente.

Valore restituito

Restituisce zero se la funzione ha esito positivo o un numero di errore se si verifica un errore. I valori restituiti possibili sono i seguenti:

LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_OPERATIONUNAVAIL.

Commenti

Il provider di servizi seleziona la versione dell'estensione indicata. Anche se il numero di versione indicato potrebbe essere stato negoziato correttamente, è possibile che sia stata selezionata una versione diversa dell'estensione nel frattempo, nel qual caso questa funzione ha esito negativo (restituendo LINEERR_INCOMPATIBLEEXTVERSION).

Le operazioni successive sulla riga dopo che è stata selezionata una versione dell'estensione si comportano in base a tale versione dell'estensione. I tentativi successivi di negoziare il report della versione dell'estensione sono rigorosamente la versione selezionata o 0 (se l'intervallo richiesto non include la versione selezionata). La chiamata a questa procedura con l'estensione speciale versione 0 annulla la selezione corrente. Il dispositivo diventa ancora una volta in grado di supportare l'intera gamma di numeri di versione dell'estensione.

Questa funzione non ha corrispondenza diretta a livello TAPI, in cui la selezione di una versione dell'estensione viene combinata con le altre funzionalità di lineOpen. La funzione TSPI_lineSelectExtVersion viene in genere chiamata in due situazioni: (1) Un'applicazione richiesta per aprire una riga, la modifica risultante del monitoraggio del tipo di supporto ha avuto esito positivo, l'applicazione ha richiesto che venga usata una determinata versione dell'estensione e non è stata selezionata alcuna versione dell'estensione. (2) L'ultima applicazione che usa una determinata versione di estensione ha chiuso la riga e la selezione della versione dell'estensione può essere annullata.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	tspi.h

Vedi anche

TSPI_lineNegotiateExtVersion