Função lineGetCallInfo (tapi.h)
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.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | tapi.h |
| Biblioteca | Tapi32.lib |
| DLL | Tapi32.dll |