Función lineGetTranslateCaps (tapi.h)

Artículo
03/08/2023

La función lineGetTranslateCaps devuelve funcionalidades de traducción de direcciones.

Sintaxis

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

Parámetros

hLineApp

Identificador devuelto por la función lineInitializeEx . Si una aplicación aún no ha llamado a la función lineInitializeEx , este parámetro puede ser cero.

Nota Las aplicaciones TAPI 1.4 deben establecer este parámetro en un identificador de hLineApp válido, tal como lo devuelve la función lineInitialize .

dwAPIVersion

Versión más alta de TAPI compatible con la aplicación (no necesariamente el valor negociado por lineNegotiateAPIVersion en algún dispositivo de línea concreto).

lpTranslateCaps

Puntero a una ubicación a la que se carga una estructura LINETRANSLATECAPS . Antes de llamar a lineGetTranslateCaps, la aplicación debe establecer el miembro dwTotalSize de esta estructura para indicar la cantidad de memoria disponible para TAPI para devolver información.

Nota Si los parámetros de tamaño de la estructura no son correctos, existe la posibilidad de que se sobrescriban los datos. Para obtener más información sobre cómo establecer tamaños de estructura, consulte el tema de asignación de memoria .

Valor devuelto

Devuelve cero si la solicitud se realiza correctamente o un número de error negativo si se produce un error. Los valores devueltos posibles son:

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM, LINEERR_INIFILECORRUPT, LINEERR_OPERATIONFAILED, LINEERR_INVALAPPHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NODRIVER.