lineSetCurrentLocation-Funktion (tapi.h)

Die lineSetCurrentLocation-Funktion legt den Speicherort fest, der als Kontext für die Adressübersetzung verwendet wird.

Syntax

LONG lineSetCurrentLocation(
  HLINEAPP hLineApp,
  DWORD    dwLocation
);

Parameter

hLineApp

Von lineInitializeEx zurückgegebenes Anwendungshandle. Wenn eine Anwendung die lineInitializeEx-Funktion noch nicht aufgerufen hat, kann sie den hLineApp-Parameter auf Null festlegen.

dwLocation

Neuer Wert für den CurrentLocation-Eintrag im Abschnitt [Locations] in der Registrierung. Er muss einen gültigen dauerhaften Bezeichner eines Standorteintrags im Abschnitt [Speicherorte] enthalten, wie er von lineGetTranslateCaps abgerufen wird. Wenn er gültig ist, wird der CurrentLocation-Eintrag aktualisiert.

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_INIFILECORRUPT, LINEERR_NOMEM, LINEERR_INVALAPPHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALLOCATION, LINEERR_RESOURCEUNAVAIL, LINEERR_NODRIVER, LINEERR_UNINITIALIZED.

Anforderungen

   
Zielplattform Windows
Kopfzeile tapi.h
Bibliothek Tapi32.lib
DLL Tapi32.dll

Weitere Informationen

Grundlegende Referenz zu Telefoniediensten

ÜBERSICHT ÜBER TAPI 2.2-Referenz

lineGetTranslateCaps

lineInitializeEx