lineGetCountry-Funktion (tapi.h)
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.
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi.h |
| Bibliothek | Tapi32.lib |
| DLL | Tapi32.dll |
Weitere Informationen
Grundlegende Referenz zu Telefoniediensten