funzione lineGetAddressID (tapi.h)

Articolo
03/02/2024

La funzione lineGetAddressID restituisce l'identificatore di indirizzo associato a un indirizzo in un formato diverso nella riga specificata.

Sintassi

LONG lineGetAddressID(
  HLINE   hLine,
  LPDWORD lpdwAddressID,
  DWORD   dwAddressMode,
  LPCSTR  lpsAddress,
  DWORD   dwSize
);

Parametri

hLine

Gestire il dispositivo a riga aperta.

lpdwAddressID

Puntatore a un percorso di memoria di dimensioni DWORD in cui viene restituito l'identificatore di indirizzo. Un identificatore di indirizzo è associato definitivamente a un indirizzo; l'identificatore rimane costante tra gli aggiornamenti del sistema operativo.

dwAddressMode

Modalità indirizzo dell'indirizzo contenuto in lpsAddress. Questo parametro usa uno e solo uno dei costanti LINEADDRESSMODE_. È necessario specificare LINEADDRESSMODE_DIALABLEADDR.

lpsAddress

Puntatore a una struttura di dati che contiene l'indirizzo assegnato al dispositivo riga specificato. Il formato dell'indirizzo è determinato da dwAddressMode. Poiché l'unico valore valido è LINEADDRESSMODE_DIALABLEADDR, lpsAddress usa il formato numero chiamabile comune e viene terminato null.

dwSize

Dimensioni, in byte, dell'indirizzo contenuto in lpsAddress. Le dimensioni della stringa devono includere il terminatore Null.

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_INVALLINEHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALADDRESS, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Commenti

La funzione lineGetAddressID viene usata per eseguire il mapping di un numero di telefono (indirizzo) assegnato a un dispositivo line al relativo dwAddressID nell'intervallo zero al numero di indirizzi meno uno restituito nelle funzionalità del dispositivo della riga. La funzione lineMakeCall consente all'applicazione di effettuare una chiamata specificando un handle di riga e un indirizzo sulla riga. L'indirizzo può essere specificato come dwAddressID, come numero di telefono o come nome o identificatore specifici del dispositivo. L'uso di un numero di telefono può essere pratico negli ambienti in cui una singola riga viene assegnata a più indirizzi.

Nota LINEADDRESSMODE_ADDRESSID può non essere usato con lineGetAddressID.