Função lineGetTranslateCaps (tapi.h)

Artigo
08/26/2023

A função lineGetTranslateCaps retorna recursos de tradução de endereço.

Sintaxe

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

Parâmetros

hLineApp

Identificador retornado pela função lineInitializeEx . Se um aplicativo ainda não tiver chamado a função lineInitializeEx , esse parâmetro poderá ser zero.

Nota Os aplicativos TAPI 1.4 devem definir esse parâmetro como um identificador hLineApp válido, conforme retornado pela função lineInitialize .

dwAPIVersion

Versão mais alta do TAPI compatível com o aplicativo (não necessariamente o valor negociado por lineNegotiateAPIVersion em algum dispositivo de linha específico).

lpTranslateCaps

Ponteiro para um local para o qual uma estrutura LINETRANSLATECAPS é carregada. Antes de chamar lineGetTranslateCaps, o aplicativo deve definir o membro dwTotalSize dessa estrutura para indicar a quantidade de memória disponível para TAPI para retornar informações.

Nota Se os parâmetros de tamanho na estrutura não estiverem corretos, há a possibilidade de que os dados possam ser substituídos. Para obter mais informações sobre como definir tamanhos de estrutura, consulte o tópico alocação de memória .

Valor retornado

Retornará zero se a solicitação for bem-sucedida ou um número de erro negativo se ocorrer um erro. Os possíveis valores retornados são:

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