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

Vedi anche

INITIALIZE_NEGOTIATION

TSPI_lineNegotiateTSPIVersion