Função lineGetCallInfo (tapi.h)

Artigo
03/05/2024

A função lineGetCallInfo permite que um aplicativo obtenha informações fixas sobre a chamada especificada.

Sintaxe

LONG lineGetCallInfo(
  HCALL          hCall,
  LPLINECALLINFO lpCallInfo
);

Parâmetros

hCall

Manipule para a chamada a ser consultada. O estado de chamada de hCall pode ser qualquer estado.

lpCallInfo

Ponteiro para uma estrutura de dados de tamanho variavelmente do tipo LINECALLINFO. Após a conclusão bem-sucedida da solicitação, essa estrutura é preenchida com informações relacionadas à chamada. Antes de chamar lineGetCallInfo, o aplicativo deve definir o membro dwTotalSize dessa estrutura para indicar a quantidade de memória disponível para TAPI para retornar informações.

Retornar valor

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

LINEERR_INVALCALLHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL.

Comentários

Existe uma estrutura LINECALLINFO separada para cada chamada de entrada ou saída. A estrutura contém principalmente informações fixas sobre a chamada. Um aplicativo normalmente estaria interessado em verificar essas informações quando recebe seu identificador para uma chamada pela mensagem de LINE_CALLSTATE ou cada vez que recebe uma notificação por um LINE_CALLINFO mensagem de que partes da estrutura de informações de chamada foram alteradas. Essas mensagens fornecem o identificador para a chamada como um parâmetro.