RasGetCountryInfoA-Funktion (ras.h)

Die RasGetCountryInfo-Funktion ruft länder-/regionsspezifische Wählinformationen aus der Windows-Telefonieliste der Länder/Regionen ab.

Weitere Informationen zu länder-/regionsspezifischen Wählinformationen und TAPI-Bezeichnern (Telephony Application Programming Interface) finden Sie im TAPI-Teil des Platform Software Development Kit (SDK).

Syntax

DWORD RasGetCountryInfoA(
  [in, out] LPRASCTRYINFOA unnamedParam1,
  [in, out] LPDWORD        unnamedParam2
);

Parameter

[in, out] unnamedParam1

Zeiger auf eine RASCTRYINFO-Struktur , die bei der Ausgabe die länder-/regionsspezifischen Wählinformationen empfängt, gefolgt von zusätzlichen Bytes für eine Länder-/Regionsbeschreibungszeichenfolge.

Legen Sie bei der Eingabe den dwSize-Member der Struktur auf sizeof(RASCTRYINFO) fest, um die Version der Struktur zu identifizieren. Legen Sie außerdem das dwCountryId-Mitglied auf den TAPI-Landes-/Regionsbezeichner des Landes/der Region fest, für das/die Informationen abgerufen werden sollen.

Weisen Sie mindestens 256 Bytes für den Puffer zu.

[in, out] unnamedParam2

Zeiger auf eine Variable, die bei der Eingabe die Größe des Puffers in Bytes angibt, auf den der lpRasCtryInfo-Parameter verweist.

Bei der Ausgabe empfängt diese Variable die erforderliche Anzahl von Bytes.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes oder ein Wert aus Routing- und RAS-Fehlercodes oder Winerror.h.

Wert	Bedeutung
ERROR_INVALID_USER_BUFFER	Die von lpRasCtryInfo angegebene Adresse oder der puffer ist ungültig.
ERROR_INVALID_PARAMETER	Der dwCountryId-Member der Struktur, auf die lpRasCtryInfo verweist, war kein gültiger Wert.
ERROR_BUFFER_TOO_SMALL	Die Größe des lpRasCtryInfo-Puffers , der durch den lpdwSize-Parameter angegeben wurde, war nicht groß genug, um die Informationen für das Land/die Region zu speichern, die vom dwCountryId-Element identifiziert wurden. Die Funktion gibt die erforderliche Puffergröße in der Variablen zurück, auf die lpdwSize verweist.
ERROR_TAPI_CONFIGURATION	Die INFORMATIONEN des TAPI-Subsystems wurden beschädigt.

Hinweise

Um Informationen für alle Länder/Regionen in der Windows-Telefonieliste aufzulisten, legen Sie im ersten RasGetCountryInfo-Aufruf das element dwCountryId der RASCTRYINFO-Struktur auf 1 fest. Dies bewirkt, dass die Funktion Informationen für das erste Land/die erste Region in der Liste zurückgibt. Der wert, der im dwNextCountryID-Mitglied zurückgegeben wird, ist der Landes-/Regionsbezeichner des nächsten Landes/der nächsten Region in der Liste. Verwenden Sie diesen Wert in wiederholten Aufrufen von RasGetCountryInfo , bis dwNextCountryID null zurückgibt, was das letzte Land bzw. die letzte Region in der Liste angibt.

Hinweis

Der ras.h-Header definiert RasGetCountryInfo als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ras.h
Bibliothek	Rasapi32.lib
DLL	Rasapi32.dll

Weitere Informationen

RASCTRYINFO

Übersicht über ras (Remote Access Service, RAS)

Funktionen des RAS-Diensts