funzione TSPI_phoneNegotiateExtVersion (tspi.h)

La funzione TSPI_phoneNegotiateExtVersion restituisce il numero di versione dell'estensione più alto in cui il provider di servizi può operare per questo dispositivo, in base all'intervallo di versioni possibili dell'estensione.

Sintassi

LONG TSPIAPI TSPI_phoneNegotiateExtVersion(
  DWORD   dwDeviceID,
  DWORD   dwTSPIVersion,
  DWORD   dwLowVersion,
  DWORD   dwHighVersion,
  LPDWORD lpdwExtVersion
);

Parametri

dwDeviceID

Identifica il dispositivo telefonico per il quale deve essere eseguita la negoziazione della versione dell'interfaccia.

dwTSPIVersion

Specifica un numero di versione dell'interfaccia negoziato per questo dispositivo tramite TSPI_phoneNegotiateTSPIVersion. Questa funzione opera in base alla specifica dell'interfaccia a questo livello di versione.

dwLowVersion

Numero di versione dell'estensione più basso in base al quale può funzionare TAPI o l'applicazione client. Word più significativo è il numero di versione principale e word meno significativo è il numero di versione secondaria.

dwHighVersion

Numero di versione dell'estensione più alto in base al quale può funzionare TAPI o l'applicazione client. Word più significativo è il numero di versione principale e word meno significativo è il numero di versione secondaria.

lpdwExtVersion

Puntatore a un DWORD. Al termine della restituzione da questa funzione, il provider di servizi riempie questa posizione con il numero di versione più alto dell'estensione, 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 PHONEERR_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:

PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_OPERATIONFAILED, PHONEERR_NODRIVER, PHONEERR_OPERATIONUNAVAIL PHONEERR_NOMEM.

Commenti

Questa funzione può essere chiamata prima o dopo l'apertura del dispositivo tramite TAPI. Se il dispositivo è attualmente aperto e ha una versione dell'estensione selezionata, la funzione deve restituire tale numero di versione se è compreso nell'intervallo richiesto. Se il numero di versione selezionato non rientra nell'intervallo richiesto, la funzione restituisce PHONEERR_INCOMPATIBLEEXTVERSION.

Requisiti

Vedi anche

TSPI_phoneNegotiateTSPIVersion