Funzione RasGetCountryInfoA (ras.h)

Articolo
11/20/2024

La funzione RasGetCountryInfo recupera le informazioni di composizione specifiche del paese/area geografica dall'elenco di paesi/aree geografiche di Windows.

Per altre informazioni sulla composizione specifica del paese o dell'area geografica e TAPI (Telephony Application Programming Interface) identificatori di paese/area geografica, vedere la parte TAPI di 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 paese/area geografica.

In input impostare il membro dwSize della struttura su sizeof(RASCTRYINFO) per identificare la versione della struttura. Impostare inoltre il membro dwCountryId sull'identificatore paese/area geografica 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 di Codici di errore di routing e 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 è valido.
ERROR_BUFFER_TOO_SMALL	Le dimensioni del buffer lpRasCtryInfo specificato dal parametro lpdwSize non sono sufficienti per archiviare le informazioni per il paese o l'area geografica identificata dal membro dwCountryId. La funzione restituisce la dimensione del buffer richiesta nella variabile a cui punta lpdwSize.
ERROR_TAPI_CONFIGURATION	Informazioni sul sottosistema TAPI danneggiate.

Osservazioni

Per enumerare le informazioni per tutti i paesi/aree geografiche nell'elenco Di telefonia Windows, impostare il membro dwCountryId RASCTRYINFO su 1 nella chiamata iniziale RasGetCountryInfo. In questo modo la funzione restituisce informazioni per il primo paese o area geografica nell'elenco. Il valore restituito nel dwNextCountryID membro è l'identificatore del paese o dell'area geografica successiva nell'elenco. Usare questo valore nelle chiamate ripetute a RasGetCountryInfo fino a quando dwNextCountryID restituisce zero, che indica l'ultimo paese o 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	ras.h
libreria	Rasapi32.lib
dll	Rasapi32.dll

Vedere anche

RASCTRYINFO

Panoramica servizio di accesso remoto (RAS)

funzioni del servizio accesso remoto

Condividi tramite