Função lineGetNewCalls (tapi.h)
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.
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.
Requisitos
Requisito | Valor |
---|---|
Plataforma de Destino | Windows |
Cabeçalho | tapi.h |
Biblioteca | Tapi32.lib |
DLL | Tapi32.dll |
Confira também
Referência básica dos Serviços de Telefonia