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
| 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