Função lineGetNewCalls (tapi.h)

Artigo
03/02/2024

A função lineGetNewCalls retorna identificadores de chamada para chamadas em uma linha ou endereço especificado para o qual o aplicativo atualmente não tem identificadores. O aplicativo recebe privilégio de monitor para essas chamadas.

Sintaxe

LONG lineGetNewCalls(
  HLINE          hLine,
  DWORD          dwAddressID,
  DWORD          dwSelect,
  LPLINECALLLIST lpCallList
);

Parâmetros

hLine

Manipule para um dispositivo de linha aberta.

dwAddressID

Endereço no dispositivo de linha aberta especificado. Um identificador de endereço está permanentemente associado a um endereço; o identificador permanece constante entre as atualizações do sistema operacional.

dwSelect

Seleção de chamadas solicitadas. Esse parâmetro usa uma e apenas uma das constantes LINECALLSELECT_.

lpCallList

Ponteiro para uma estrutura de dados de tamanho variável do tipo LINECALLLIST. Após a conclusão bem-sucedida da solicitação, os identificadores de chamada para todas as chamadas selecionadas são retornados nessa estrutura. Antes de chamar lineGetNewCalls, 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 .

Retornar valor

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_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSELECT, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED LINEERR_NOMEM.

Comentários

Um aplicativo pode usar lineGetNewCalls para obter identificadores para chamadas para as quais atualmente não tem identificadores. O aplicativo pode selecionar as chamadas para as quais os identificadores devem ser retornados baseando essa seleção no escopo (chamadas em uma linha especificada ou chamadas em um endereço especificado). Por exemplo, um aplicativo pode solicitar identificadores de chamada para todas as chamadas em um determinado endereço para o qual atualmente não tem identificador. O aplicativo sempre recebe privilégio de monitor para os novos identificadores de chamada. Além disso, ao abrir uma linha, um aplicativo usa essa função para se tornar ciente das chamadas existentes.

O aplicativo pode invocar lineGetCallInfo e lineGetCallStatus para cada chamada na lista para determinar as informações e status da chamada, respectivamente. Ele pode usar lineSetCallPrivilege para alterar seu privilégio para proprietário.