Funzione lineGetAddressIDA (tapi.h)
La funzione lineGetAddressID restituisce l'identificatore di indirizzo associato a un indirizzo in un formato diverso sulla riga specificata.
LONG lineGetAddressIDA(
HLINE hLine,
LPDWORD lpdwAddressID,
DWORD dwAddressMode,
LPCSTR lpsAddress,
DWORD dwSize
);
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.
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.
La funzione
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.
Requisito | Valore |
---|---|
piattaforma di destinazione | Finestre |
intestazione |
tapi.h |
libreria |
Tapi32.lib |
dll | Tapi32.dll |
di riferimento dei servizi di telefonia di base