lineGetTranslateCaps-Funktion (tapi.h)

Artikel
08/26/2023

Die lineGetTranslateCaps-Funktion gibt Funktionen zur Adressübersetzung zurück.

Syntax

LONG lineGetTranslateCaps(
  HLINEAPP            hLineApp,
  DWORD               dwAPIVersion,
  LPLINETRANSLATECAPS lpTranslateCaps
);

Parameter

hLineApp

Von der lineInitializeEx-Funktion zurückgegebenes Handle. Wenn eine Anwendung die lineInitializeEx-Funktion noch nicht aufgerufen hat, kann dieser Parameter 0 sein.

Hinweis TAPI 1.4-Anwendungen müssen diesen Parameter auf ein gültiges hLineApp-Handle festlegen, wie er von der lineInitialize-Funktion zurückgegeben wird.

dwAPIVersion

Höchste VERSION von TAPI, die von der Anwendung unterstützt wird (nicht unbedingt der von lineNegotiateAPIVersion auf einem bestimmten Zeilengerät ausgehandelte Wert).

lpTranslateCaps

Zeiger auf einen Speicherort, an den eine LINETRANSLATECAPS-Struktur geladen wird. Vor dem Aufrufen von lineGetTranslateCaps muss die Anwendung den dwTotalSize-Member dieser Struktur festlegen, um die Menge an Arbeitsspeicher anzugeben, der 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 Speicherzuordnung .

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_INVALAPPHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NODRIVER.