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 |