Condividi tramite


funzione lineGetTranslateCaps (tapi.h)

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.

Requisiti

   
Piattaforma di destinazione Windows
Intestazione tapi.h
Libreria Tapi32.lib
DLL Tapi32.dll

Vedi anche

Informazioni di riferimento sui servizi di telefonia di base

LINETRANSLATECAPS

Panoramica di riferimento su TAPI 2.2

lineInitializeEx

lineNegotiateAPIVersion