função TSPI_lineSetCallData (tspi.h)

  • Artigo

O TSPI_lineSetCallData provedor de serviços de funções armazena os dados de chamada indicados com suas informações relacionadas à chamada e, posteriormente, os entrega sempre que TSPI_lineGetCallInfo é chamado. O provedor de serviços envia uma mensagem LINE_CALLINFO indicando LINECALLINFOSTATE_CALLDATA para mostrar que os dados de chamada foram alterados. Dependendo da implementação do provedor de serviços, os dados de chamada podem ser propagados para todas as entidades que têm identificadores para a chamada, incluindo aqueles em outros computadores (por meio do servidor), e podem viajar com a chamada quando ela é transferida.

Sintaxe

LONG TSPIAPI TSPI_lineSetCallData(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPVOID        lpCallData,
  DWORD         dwSize
);

Parâmetros

dwRequestID

Identificador para relatar informações de conclusão assíncronas.

hdCall

O identificador do provedor de serviços para a chamada.

lpCallData

Endereço dos dados a serem copiados para o campo CallData em LINECALLINFO, substituindo todos os dados existentes.

dwSize

Número de bytes de dados a serem copiados. Um valor zero faz com que todos os dados existentes sejam removidos. Se o parâmetro lpCallData for um ponteiro para uma cadeia de caracteres, o tamanho deverá incluir o terminador nulo .

Retornar valor

Retorna dwRequestID se a operação assíncrona for iniciada; caso contrário, um destes valores de erro negativos:

LINEERR_INVALCALLSTATE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_RESOURCEUNAVAIL.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tspi.h

Confira também

LINECALLINFO

LINE_CALLINFO

TSPI_lineGetCallInfo