Função lineGetCallStatus (tapi.h)

Artigo
08/26/2023

A função lineGetCallStatus retorna o status atual da chamada especificada.

Sintaxe

LONG lineGetCallStatus(
  HCALL            hCall,
  LPLINECALLSTATUS lpCallStatus
);

Parâmetros

hCall

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

lpCallStatus

Ponteiro para uma estrutura de dados de tamanho variável do tipo LINECALLSTATUS. Após a conclusão bem-sucedida da solicitação, essa estrutura é preenchida com informações de status de chamada. Antes de chamar lineGetCallStatus, 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 de 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 valores retornados possíveis são:

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

Comentários

A função lineGetCallStatus retorna o status dinâmico de uma chamada, enquanto lineGetCallInfo retorna principalmente informações estáticas sobre uma chamada. Chamar status informações incluem o estado de chamada atual, informações detalhadas de modo relacionadas à chamada enquanto estiver nesse estado (se houver), bem como uma lista das funções de API disponíveis que o aplicativo pode invocar na chamada enquanto a chamada estiver nesse estado. Normalmente, um aplicativo estaria interessado em solicitar essas informações quando recebe uma notificação sobre uma alteração de estado de chamada pela mensagem LINE_CALLSTATE.