Funzione lineGetCountry (tapi.h)

  • Articolo

La funzione lineGetCountry recupera le regole di composizione archiviate e altre informazioni correlate a un paese/area geografica specificato, al primo paese/area geografica nell'elenco paese/area geografica o a tutti i paesi/aree geografiche.

Sintassi

LONG lineGetCountry(
  DWORD             dwCountryID,
  DWORD             dwAPIVersion,
  LPLINECOUNTRYLIST lpLineCountryList
);

Parametri

dwCountryID

Identificatore paese/area geografica (non il codice paese) del paese/area geografica per cui ottenere le informazioni. Se viene specificato il valore 1, vengono ottenute informazioni sul primo paese/area geografica nell'elenco paese/area geografica. Se viene specificato il valore 0, vengono ottenute informazioni su tutti i paesi/aree geografiche (che possono richiedere una grande quantità di memoria, ovvero 20 KB o più).

dwAPIVersion

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

lpLineCountryList

Puntatore a una posizione in cui viene caricata una struttura LINECOUNTRYLIST . Prima di chiamare lineGetCountry, 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_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM, LINEERR_INIFILECORRUPT, LINEERR_OPERATIONFAILED, LINEERR_INVALCOUNTRYCODE, LINEERR_STRUCTURETOOSMALL LINEERR_INVALPOINTER.

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

LINECOUNTRYLIST

Panoramica dei riferimenti a TAPI 2.2

lineNegotiateAPIVersion