Função lineSetAppSpecific (tapi.h)

Artigo
03/02/2024

A função lineSetAppSpecific permite que um aplicativo defina o campo específico do aplicativo do registro de informações de chamada da chamada especificada.

Sintaxe

LONG lineSetAppSpecific(
  HCALL hCall,
  DWORD dwAppSpecific
);

Parâmetros

hCall

Manipule para a chamada cujo campo específico do aplicativo precisa ser definido. O aplicativo deve ser um proprietário da chamada. O estado de chamada de hCall pode ser qualquer estado.

dwAppSpecific

Novo conteúdo do membro dwAppSpecific para a estrutura LINECALLINFO da chamada. Esse valor não é interpretado pela API de Telefonia.

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_INVALCALLHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_NOTOWNER, LINEERR_OPERATIONUNAVAIL, LINEERR_OPERATIONFAILED.

Comentários

O campo específico do aplicativo na estrutura de dados LINECALLINFO que existe para cada chamada não é interpretado pela API de Telefonia ou por qualquer um de seus provedores de serviços. Seu uso é totalmente definido pelos aplicativos. O campo pode ser lido do registro LINECALLINFO retornado por lineGetCallInfo. No entanto, lineSetAppSpecific deve ser usado para definir o campo para que as alterações se tornem visíveis para outros aplicativos. Quando esse campo é alterado, todos os outros aplicativos com identificadores de chamada são enviados uma mensagem LINE_CALLINFO com uma indicação de que o membro dwAppSpecific foi alterado.