funzione lineGetTranslateCaps (tapi.h)

Articolo
03/08/2023

La funzione lineGetTranslateCaps restituisce le funzionalità di traduzione degli indirizzi.

Sintassi

LONG lineGetTranslateCaps(
  HLINEAPP            hLineApp,
  DWORD               dwAPIVersion,
  LPLINETRANSLATECAPS lpTranslateCaps
);

Parametri

hLineApp

Handle restituito dalla funzione lineInitializeEx . Se un'applicazione non ha ancora chiamato la funzione lineInitializeEx , questo parametro può essere zero.

Nota Le applicazioni TAPI 1.4 devono impostare questo parametro su un handle hLineApp valido, come restituito dalla funzione lineInitialize .

dwAPIVersion

Versione più alta di TAPI supportata dall'applicazione (non necessariamente il valore negoziato da lineNegotiateAPIVersion in un determinato dispositivo linea).

lpTranslateCaps

Puntatore a una posizione a cui viene caricata una struttura LINETRANSLATECAPS . Prima di chiamare lineGetTranslateCaps, l'applicazione deve impostare il membro dwTotalSize di questa struttura per indicare la quantità di memoria disponibile per TAPI per restituire informazioni.

Nota Se i parametri delle dimensioni nella struttura non sono corretti, è possibile che i dati possano essere sovrascritti. Per altre informazioni sull'impostazione delle dimensioni della struttura, vedere l'argomento relativo all'allocazione della memoria .

Valore restituito

Restituisce zero se la richiesta ha esito positivo o un numero di errore negativo se si verifica un errore. I valori restituiti possibili sono:

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM, LINEERR_INIFILECORRUPT, LINEERR_OPERATIONFAILED, LINEERR_INVALAPPHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NODRIVER.