funzione TSPI_lineNegotiateTSPIVersion (tspi.h)

Articolo
03/03/2024

La funzione TSPI_lineNegotiateTSPIVersion restituisce la versione SPI più elevata in cui il provider di servizi può operare per questo dispositivo, dato l'intervallo di versioni SPI possibili.

Sintassi

LONG TSPIAPI TSPI_lineNegotiateTSPIVersion(
  DWORD   dwDeviceID,
  DWORD   dwLowVersion,
  DWORD   dwHighVersion,
  LPDWORD lpdwTSPIVersion
);

Parametri

dwDeviceID

Identifica il dispositivo linea per il quale deve essere eseguita la negoziazione della versione dell'interfaccia. Oltre agli identificatori di dispositivo all'interno dell'intervallo supportato dal provider di servizi, questo può essere il valore:

INITIALIZE_NEGOTIATION

Questo valore viene usato per indicare che deve essere negoziata una versione complessiva dell'interfaccia.

dwLowVersion

Numero di versione TSPI più basso in base al quale può funzionare TAPI. Word più significativo è il numero di versione principale e word meno significativo è il numero di versione secondaria.

dwHighVersion

Numero di versione TSPI più alto in base al quale è possibile operare TAPI. Word più significativo è il numero di versione principale e word meno significativo è il numero di versione secondaria.

lpdwTSPIVersion

Puntatore a un DWORD. Il provider di servizi riempie questa posizione con il numero di versione TSPI più alto, compreso nell'intervallo richiesto dal chiamante, in base al quale il provider di servizi può operare. Word più significativo è il numero di versione principale e word meno significativo è il numero di versione secondaria. Se l'intervallo richiesto non si sovrappone all'intervallo supportato dal provider di servizi, la funzione restituisce LINEERR_INCOMPATIBLEAPIVERSION.

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_NODRIVER, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Commenti

Quando dwDeviceID è INITIALIZE_NEGOTIATION, questa funzione non deve restituire LINEERR_OPERATIONUNAVAIL, perché questa funzione (con tale valore) è obbligatoria per negoziare la versione complessiva dell'interfaccia anche se il provider di servizi non supporta dispositivi line.