Funzione RasGetCountryInfoA (ras.h)

  • Articolo

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
ERROR_INVALID_USER_BUFFER
 L'indirizzo o il buffer specificato da lpRasCtryInfo non è valido.
ERROR_INVALID_PARAMETER
 Il membro dwCountryId della struttura a cui punta lpRasCtryInfo non era un valore valido.
ERROR_BUFFER_TOO_SMALL
 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.
ERROR_TAPI_CONFIGURATION
 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

Vedi anche

RASCTRYINFO

Panoramica del servizio di accesso remoto (RAS)

Funzioni del Servizio di accesso remoto