Funzione lineGetAddressCapsA (tapi.h)

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

Sintassi

LONG lineGetAddressCapsA(
  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 su cui eseguire una query.

dwAddressID

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

dwAPIVersion

Numero di versione dell'API di telefonia da usare. La parola di ordine elevato contiene il numero di versione principale; La parola con ordine basso contiene il numero di versione secondario. Questo numero viene ottenuto lineNegotiateAPIVersion.

dwExtVersion

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

lpAddressCaps

Puntatore a una struttura di dimensioni variabili di tipo LINEADDRESSCAPS. Al completamento della richiesta, questa struttura viene compilata con informazioni sulle funzionalità di indirizzo. Prima di chiamare lineGetAddressCaps, 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 allocazione di memoria.

 

Valore restituito

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

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

Osservazioni

Gli identificatori di indirizzo validi sono compresi tra zero e uno minore del 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.

Nota

L'intestazione tapi.h definisce lineGetAddressCaps 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

LINEADDRESSCAPS

panoramica dei riferimenti TAPI 2.2

lineGetDevCaps

rigaNegotiateAPIVersion