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(Telefonie Application Programming Interface) Länder-/Regions-IDs 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 Zeichenfolge für die Beschreibung eines Landes/einer Region.
Legen Sie bei eingaben den dwSize Member der Struktur auf "sizeof(RASCTRYINFO) fest, um die Version der Struktur zu identifizieren. Legen Sie außerdem die dwCountryId Mitglied auf den TAPI-Länder-/Regionsbezeichner des Landes/der Region fest, für das Informationen abgerufen werden sollen.
Weisen Sie mindestens 256 Bytes für den Puffer zu.
[in, out] unnamedParam2
Zeiger auf eine Variable, die bei eingabe die Größe des Puffers in Byte angibt, auf den der lpRasCtryInfo-Parameter verweist.
Bei der Ausgabe empfängt diese Variable die Anzahl der erforderlichen 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 Remotezugriffsfehlercodes oder Winerror.h.
| Wert | Bedeutung |
|---|---|
|
Die durch lpRasCtryInfo angegebene Adresse oder der Puffer ist ungültig. |
|
Das dwCountryId- Element der Struktur, auf das von lpRasCtryInfo verwiesen wurde, war kein gültiger Wert. |
|
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, das durch das dwCountryId Mitglied identifiziert wurde. Die Funktion gibt die erforderliche Puffergröße in der Variablen zurück, auf die durch lpdwSizeverwiesen wird. |
|
TAPI-Subsysteminformationen wurden beschädigt. |
Bemerkungen
Wenn Sie Informationen für alle Länder/Regionen in der Liste der Windows-Telefonie aufzählen möchten, legen Sie die dwCountryId Mitglied der RASCTRYINFO- Struktur in der anfänglichen RasGetCountryInfo Anruf auf 1 fest. Dies bewirkt, dass die Funktion Informationen für das erste Land/die erste Region in der Liste zurückgibt. Der in der dwNextCountryID Mitglied zurückgegebene Wert ist der Länder-/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/die letzte Region in der Liste angibt.
Anmerkung
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 |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | ras.h |
| Library | Rasapi32.lib |
| DLL- | Rasapi32.dll |
Siehe auch
übersicht über Ras(Remote Access Service)