funzione lineGetProviderList (tapi.h)

La funzione lineGetProviderList restituisce un elenco di provider di servizi attualmente installati nel sistema di telefonia.

Sintassi

LONG lineGetProviderList(
  DWORD              dwAPIVersion,
  LPLINEPROVIDERLIST lpProviderList
);

Parametri

dwAPIVersion

Versione più alta di TAPI supportata dall'applicazione (non necessariamente il valore negoziato da lineNegotiateAPIVersion in un determinato dispositivo linea).

lpProviderList

Puntatore a una posizione di memoria in cui TAPI può restituire una struttura LINEPROVIDERLIST . Prima di chiamare lineGetProviderList, 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_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM, LINEERR_INIFILECORRUPT, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL.

Requisiti

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

Vedi anche

LINEPROVIDERLIST

Funzioni di servizio linea supplementari

Panoramica di riferimento su TAPI 2.2

lineNegotiateAPIVersion