Funzione lineGetCountry (tapi.h)

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.

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

Vedi anche

Informazioni di riferimento sui servizi di telefonia di base

LINECOUNTRYLIST

Panoramica dei riferimenti a TAPI 2.2

lineNegotiateAPIVersion