lineGetCountry-Funktion (tapi.h)

Artikel
03/02/2024

Die lineGetCountry-Funktion ruft die gespeicherten Wählregeln und andere Informationen ab, die sich auf ein angegebenes Land/eine bestimmte Region, das erste Land/die erste Region in der Länder-/Regionsliste oder alle Länder/Regionen beziehen.

Syntax

LONG lineGetCountry(
  DWORD             dwCountryID,
  DWORD             dwAPIVersion,
  LPLINECOUNTRYLIST lpLineCountryList
);

Parameter

dwCountryID

Landes-/Regionsbezeichner (nicht länderspezifischer Code) des Landes/der Region, für das/die Informationen abgerufen werden sollen. Wenn der Wert 1 angegeben ist, werden Informationen über das erste Land/die erste Region in der Länder-/Regionsliste abgerufen. Wenn der Wert 0 angegeben ist, werden Informationen zu allen Ländern/Regionen abgerufen (was sehr viel Arbeitsspeicher erfordern kann – 20 KB oder mehr).

dwAPIVersion

Höchste tapi-Version, die von der Anwendung unterstützt wird (nicht unbedingt der wert, der von lineNegotiateAPIVersion auf einem bestimmten Leitungsgerät ausgehandelt wird).

lpLineCountryList

Zeiger auf einen Speicherort, an den eine LINECOUNTRYLIST-Struktur geladen wird. Vor dem Aufruf von lineGetCountry muss die Anwendung den dwTotalSize-Member dieser Struktur festlegen, um anzugeben, wie viel Arbeitsspeicher TAPI zum Zurückgeben von Informationen zur Verfügung steht.

Hinweis Wenn die Größenparameter in der Struktur nicht korrekt sind, besteht die Möglichkeit, dass Daten überschrieben werden. Weitere Informationen zum Festlegen von Strukturgrößen finden Sie im Thema speicherbelegung .

Rückgabewert

Gibt null zurück, wenn die Anforderung erfolgreich ist, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM, LINEERR_INIFILECORRUPT, LINEERR_OPERATIONFAILED, LINEERR_INVALCOUNTRYCODE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER.