funzione TSPI_lineGetAddressID (tspi.h)

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

Sintassi

LONG TSPIAPI TSPI_lineGetAddressID(
  HDRVLINE hdLine,
  LPDWORD  lpdwAddressID,
  DWORD    dwAddressMode,
  LPCWSTR  lpsAddress,
  DWORD    dwSize
);

Parametri

hdLine

Handle del provider di servizi alla riga di cui recuperare l'indirizzo.

lpdwAddressID

Puntatore a un percorso di memoria di dimensioni DWORD in cui viene restituito l'identificatore di indirizzo.

dwAddressMode

Modalità di indirizzo dell'indirizzo contenuto in lpsAddress. Il parametro dwAddressMode può avere una e una delle costanti LINEADDRESSMODE_.

lpsAddress

Puntatore a una struttura di dati che contiene l'indirizzo assegnato al dispositivo linea specificato. Il formato dell'indirizzo è determinato dal parametro dwAddressMode . Se è LINEADDRESSMODE_DIALABLEADDR, il parametro lpsAddress usa il formato numero chiamabile comune e viene terminato NULL .

dwSize

Dimensione dell'indirizzo contenuto in lpsAddress. Il parametro dwSize deve essere impostato sulla lunghezza della stringa (più una per NULL) se viene utilizzata LINEADDRESSMODE_DIALABLEADDR. Se viene utilizzata una lineaDDRESSMODE estesa, la lunghezza deve corrispondere alla dimensione di qualsiasi elemento effettivamente passato (la DLL verifica che possa leggere il numero di byte specificati dal puntatore specificato).

Valore restituito

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

LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESS, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Commenti

Questa funzione viene usata per eseguire il mapping di un numero di telefono (indirizzo) assegnato a un dispositivo line al relativo dwAddressID (nell'intervallo compreso tra 0 e il numero di indirizzi meno uno) restituito nelle funzionalità del dispositivo della riga.

Requisiti

Vedi anche

costanti LINEADDRESSMODE_