funzione lineGetAddressCaps (tapi.h)

Articolo
03/02/2024

La funzione lineGetAddressCaps esegue una query sull'indirizzo specificato nel dispositivo linea specificato per determinare le funzionalità di telefonia.

Sintassi

LONG lineGetAddressCaps(
  HLINEAPP          hLineApp,
  DWORD             dwDeviceID,
  DWORD             dwAddressID,
  DWORD             dwAPIVersion,
  DWORD             dwExtVersion,
  LPLINEADDRESSCAPS lpAddressCaps
);

Parametri

hLineApp

Gestire la registrazione dell'applicazione con TAPI.

dwDeviceID

Dispositivo linea contenente l'indirizzo da eseguire una query.

dwAddressID

Indirizzo nel dispositivo linea specificato le cui funzionalità devono essere eseguite query. Un identificatore di indirizzo è associato definitivamente a un indirizzo; l'identificatore rimane costante tra gli aggiornamenti del sistema operativo.

dwAPIVersion

Numero di versione dell'API Telefonia da usare. La parola ad ordine elevato contiene il numero di versione principale; la parola a basso ordine contiene il numero di versione secondaria. Questo numero viene ottenuto da lineNegotiateAPIVersion.

dwExtVersion

Numero di versione delle estensioni specifiche del provider di servizi da usare. Questo numero può essere impostato su zero se non vengono usate estensioni specifiche del dispositivo. In caso contrario, la parola ad ordine elevato contiene il numero di versione principale; e la parola a basso ordine contiene il numero di versione secondaria.

lpAddressCaps

Puntatore a una struttura di dimensioni variabile di tipo LINEADDRESSCAPS. Al termine della richiesta, questa struttura viene riempita con le informazioni sulle funzionalità degli indirizzi. Prima di chiamare lineGetAddressCaps, l'applicazione deve impostare il membro dwTotalSize di questa struttura per indicare la quantità di memoria disponibile per TAPI per restituire informazioni.

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

LINEERR_BADDEVICEID LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALAPPHANDLE, LINEERR_UNINITIALIZED, LINEERR_INVALPOINTER LINEERR_OPERATIONUNAVAIL, LINEERR_INVALPOINTER, LINEERR_NODRIVER, LINEERR_NODEVICE.

Commenti

Gli identificatori di indirizzo validi vanno da zero a uno inferiore al numero di indirizzi restituiti da lineGetDevCaps. Il numero di versione da specificare è il numero di versione restituito come parte delle funzionalità del dispositivo della riga da lineGetDevCaps.