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
| Piattaforma di destinazione | Windows |
| Intestazione | tspi.h |