Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die lineGetTranslateCaps- Funktion gibt Adressübersetzungsfunktionen zurück.
Syntax
LONG lineGetTranslateCapsA(
HLINEAPP hLineApp,
DWORD dwAPIVersion,
LPLINETRANSLATECAPS lpTranslateCaps
);
Parameter
hLineApp
Handle, das von der lineInitializeEx--Funktion zurückgegeben wird. Wenn eine Anwendung die funktion lineInitialize Ex noch nicht aufgerufen hat, kann dieser Parameter null sein.
Note TAPI 1.4 applications must set this parameter to a valid hLineApp handle, as returned by the lineInitialize function.
dwAPIVersion
Höchste Version von TAPI, die von der Anwendung unterstützt wird (nicht unbedingt der von lineNegotiateAPIVersion auf einem bestimmten Liniengerät ausgehandelte Wert).
lpTranslateCaps
Zeiger auf eine Position, an die eine LINETRANSLATECAPS- Struktur geladen wird. Vor dem Aufrufen lineGetTranslateCaps-muss die Anwendung das dwTotalSize Member dieser Struktur festlegen, um die Menge des für TAPI verfügbaren Arbeitsspeichers für die Rückgabe von Informationen anzugeben.
Hinweis Wenn die Größenparameter in der Struktur nicht korrekt sind, besteht die Möglichkeit, dass Daten überschrieben werden können. Weitere Informationen zum Festlegen von Strukturgrößen finden Sie im Thema Speicherzuordnung Thema.
Rückgabewert
Gibt Null zurück, wenn die Anforderung erfolgreich ist oder eine negative Fehlernummer auftritt, 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.
Bemerkungen
Anmerkung
Der header tapi.h definiert lineGetTranslateCaps 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 |
|---|---|
| Zielplattform- | Fenster |
| Header- | tapi.h |
| Library | Tapi32.lib |
| DLL- | Tapi32.dll |