Funzione RasGetCountryInfoA (ras.h)
La funzione RasGetCountryInfo recupera informazioni di composizione specifiche del paese/area geografica dall'elenco Di telefonia windows di paesi/aree geografiche.
Per altre informazioni sulle informazioni sulla composizione specifica del paese/area geografica e sugli identificatori di paese/area geografica ( TAPI), vedere la parte TAPI del Platform Software Development Kit (SDK).
Sintassi
DWORD RasGetCountryInfoA(
[in, out] LPRASCTRYINFOA unnamedParam1,
[in, out] LPDWORD unnamedParam2
);
Parametri
[in, out] unnamedParam1
Puntatore a una struttura RASCTRYINFO che, nell'output, riceve le informazioni di composizione specifiche del paese o dell'area geografica seguite da byte aggiuntivi per una stringa di descrizione del paese/area geografica.
In input impostare il membro dwSize della struttura su sizeof(RASCTRYINFO) per identificare la versione della struttura. Impostare anche il membro dwCountryId sull'identificatore di paese/area TAPI del paese/area geografica per cui ottenere informazioni.
Allocare almeno 256 byte per il buffer.
[in, out] unnamedParam2
Puntatore a una variabile che, in input, specifica le dimensioni, in byte, del buffer a cui punta il parametro lpRasCtryInfo .
Nell'output, questa variabile riceve il numero di byte necessari.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.
Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti o un valore da Routing e codici di errore di accesso remoto o Winerror.h.
| Valore | Significato |
|---|---|
|
L'indirizzo o il buffer specificato da lpRasCtryInfo non è valido. |
|
Il membro dwCountryId della struttura a cui punta lpRasCtryInfo non era un valore valido. |
|
Le dimensioni del buffer lpRasCtryInfo specificato dal parametro lpdwSize non sono sufficienti per archiviare le informazioni per il paese/area geografica identificata dal membro dwCountryId . La funzione restituisce le dimensioni del buffer necessarie nella variabile a cui punta lpdwSize. |
|
Le informazioni del sottosistema TAPI sono state danneggiate. |
Commenti
Per enumerare le informazioni per tutti i paesi/aree dell'elenco Telefonia di Windows, impostare il membro dwCountryId della struttura RASCTRYINFO su 1 nella chiamata iniziale di RasGetCountryInfo . In questo modo la funzione restituisce informazioni per il primo paese/area geografica nell'elenco. Il valore restituito nel membro dwNextCountryID è l'identificatore paese/area geografica del paese/area successiva nell'elenco. Usare questo valore nelle chiamate ripetute a RasGetCountryInfo fino a quando dwNextCountryID restituisce zero, indicando l'ultimo paese/area geografica nell'elenco.
Nota
L'intestazione ras.h definisce RasGetCountryInfo come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | ras.h |
| Libreria | Rasapi32.lib |
| DLL | Rasapi32.dll |