Leggere in inglese

Condividi tramite


Funzione lineGetAddressIDA (tapi.h)

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

Sintassi

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

Parametri

hLine

Handle per il dispositivo a riga aperta.

lpdwAddressID

Puntatore a un DWORDpercorso di memoria con dimensioni in cui viene restituito l'identificatore di indirizzo. Un identificatore di indirizzo è associato in modo permanente a un indirizzo; l'identificatore rimane costante tra gli aggiornamenti del sistema operativo.

dwAddressMode

Modalità indirizzo dell'indirizzo contenuto in lpsAddress. Questo parametro usa una sola costante LINEADDRESSMODE_. È necessario specificare LINEADDRESSMODE_DIALABLEADDR.

lpsAddress

Puntatore a una struttura di dati che contiene l'indirizzo assegnato al dispositivo linea specificato. Il formato dell'indirizzo è determinato da dwAddressMode. Poiché l'unico valore valido è LINEADDRESSMODE_DIALABLEADDR, lpsAddress usa il formato del numero di composizione comune ed è con terminazione Null.

dwSize

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

Valore restituito

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

LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALADDRESS, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Osservazioni

La funzione lineGetAddressID viene usata per eseguire il mapping di un numero di telefono (indirizzo) assegnato a un dispositivo linea 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 nella riga. L'indirizzo può essere specificato come dwAddressID, come numero di telefono o come nome o identificatore specifico del dispositivo. L'uso di un numero di telefono può essere pratico in ambienti in cui a una singola riga vengono assegnati più indirizzi.

La nota LINEADDRESSMODE_ADDRESSID non può essere usata con lineGetAddressID.
 

Nota

L'intestazione tapi.h definisce lineGetAddressID come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
piattaforma di destinazione Finestre
intestazione tapi.h
libreria Tapi32.lib
dll Tapi32.dll

Vedere anche

di riferimento dei servizi di telefonia di base

panoramica dei riferimenti TAPI 2.2

lineMakeCall