Funzione lineGetAddressStatus (tapi.h)

La funzione lineGetAddressStatus consente a un'applicazione di eseguire una query sull'indirizzo specificato per il relativo stato corrente.

Sintassi

LONG lineGetAddressStatus(
  HLINE               hLine,
  DWORD               dwAddressID,
  LPLINEADDRESSSTATUS lpAddressStatus
);

Parametri

hLine

Handle per il dispositivo a riga aperta.

dwAddressID

Indirizzo nel dispositivo open line specificato. Questo è l'indirizzo su cui eseguire una query. Un identificatore di indirizzo è associato in modo permanente a un indirizzo; l'identificatore rimane costante tra gli aggiornamenti del sistema operativo.

lpAddressStatus

Puntatore a una struttura di dati con dimensioni variabili di tipo LINEADDRESSSTATUS. Prima di chiamare lineGetAddressStatus, l'applicazione deve impostare il membro dwTotalSize di questa struttura per indicare la quantità di memoria disponibile per TAPI per la restituzione di informazioni.

Nota Se i parametri di dimensione nella struttura non sono corretti, è possibile che i dati vengano 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 negativo se si verifica un errore. I valori restituiti possibili sono:

LINEERR_INVALADDRESSID, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_OPERATIONUNAVAIL, LINEERR_OPERATIONFAILED.

Requisiti

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

Vedi anche

Informazioni di riferimento sui servizi di telefonia di base

LINEADDRESSSTATUS

Panoramica dei riferimenti a TAPI 2.2