funzione TSPI_lineNegotiateExtVersion (tspi.h)
La funzione TSPI_lineNegotiateExtVersion restituisce il numero di versione di estensione più alto in cui il provider di servizi può operare per questo dispositivo, dato l'intervallo di possibili versioni di estensione.
Sintassi
LONG TSPIAPI TSPI_lineNegotiateExtVersion(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
DWORD dwLowVersion,
DWORD dwHighVersion,
LPDWORD lpdwExtVersion
);
Parametri
dwDeviceID
Identifica il dispositivo di riga per il quale deve essere eseguita la negoziazione della versione dell'interfaccia. Il valore INITIALIZE_NEGOTIATION può non essere usato per questa funzione.
dwTSPIVersion
Numero di versione dell'interfaccia già negoziato per questo dispositivo usando TSPI_lineNegotiateTSPIVersion. Questa funzione funziona in base alla specifica dell'interfaccia a questo livello di versione.
dwLowVersion
Numero di versione dell'estensione più basso in cui è possibile operare TAPI o l'applicazione client. La PAROLA più significativa è il numero di versione principale e il numero di versione meno significativo di WORD è il numero di versione secondario. TAPI non convalida questo parametro quando questa funzione viene chiamata.
dwHighVersion
Numero di versione dell'estensione più alto in cui è possibile operare TAPI o l'applicazione client. La PAROLA più significativa è il numero di versione principale e il numero di versione meno significativo di WORD è il numero di versione secondario. TAPI non convalida questo parametro quando questa funzione viene chiamata.
lpdwExtVersion
Puntatore a un DWORD. Al termine della restituzione da questa funzione, il provider di servizi riempie questa posizione con il numero di versione di estensione più alto, all'interno dell'intervallo richiesto dal chiamante, in cui il provider di servizi può operare. La PAROLA più significativa è il numero di versione principale e il numero di versione meno significativo di WORD è il numero di versione secondario. Se l'intervallo richiesto non si sovrappone all'intervallo supportato dal provider di servizi, la funzione restituisce LINEERR_INCOMPATIBLEEXTVERSION.
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_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONUNAVAIL, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_NODRIVER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM.
Commenti
Questa funzione può essere chiamata prima o dopo l'apertura del dispositivo da TAPI. Se il dispositivo è attualmente aperto e ha una versione di estensione selezionata, la funzione fornisce tale numero di versione se è all'interno dell'intervallo richiesto. Se il numero di versione selezionato non è compreso nell'intervallo richiesto, la funzione restituisce LINEERR_INCOMPATIBLEEXTVERSION.
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | tspi.h |