função TSPI_linePark (tspi.h)

Artigo
08/26/2023

A função TSPI_linePark estaciona a chamada especificada de acordo com o modo de parque especificado.

Sintaxe

LONG TSPIAPI TSPI_linePark(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  DWORD         dwParkMode,
  LPCWSTR       lpszDirAddress,
  LPVARSTRING   lpNonDirAddress
);

Parâmetros

dwRequestID

O identificador da solicitação assíncrona.

hdCall

O identificador da chamada a ser estacionada. O estado de chamada do hdCall pode ser conectado.

dwParkMode

O modo de parque com o qual a chamada deve ser estacionada, apenas uma das constantes LINEPARKMODE_.

lpszDirAddress

Um ponteiro para a cadeia de caracteres Unicode terminada em nulo que indica o endereço em que a chamada deve ser estacionada ao usar o parque direcionado. O endereço está no formato de endereço discável. Esse parâmetro é ignorado para o parque não redirecionado.

lpNonDirAddress

Um ponteiro para uma estrutura do tipo VARSTRING. Para o parque não redirecionado, o endereço em que a chamada está estacionada é retornado nessa estrutura. Esse parâmetro é ignorado para o parque direcionado. Dentro da estrutura VARSTRING , dwStringFormat deve ser definido como STRINGFORMAT_ASCII (um buffer de cadeia de caracteres ASCII que contém uma cadeia de caracteres terminada em nulo) e o NULL de terminação é contabilizado no dwStringSize. Se a memória apontada pelo parâmetro lpNonDirAddress não for grande o suficiente para o endereço solicitado, a função TSPI_linePark retornará LINEERR_STRUCTURETOOSMALL.

Retornar valor

Retorna dwRequestID ou um número de erro se ocorrer um erro. O parâmetro real lResult do ASYNC_COMPLETION correspondente será zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os valores retornados possíveis são os seguintes:

LINEERR_INVALCALLHANDLE, LINEERR_NOMEM, LINEERR_INVALPARKMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESS, LINEERR_RESOURCEUNAVAIL LINEERR_STRUCTURETOOSMALL.

Comentários

Todos os membros da estrutura VARSTRING , exceto dwTotalSize, são preenchidos pelo provedor de serviços. O membro dwTotalSize é preenchido pelo TAPI e o provedor de serviços não deve substituir esse valor.

Em parque direcionado, o aplicativo cliente (por meio do TAPI) especifica o endereço no qual deseja estacionar a chamada. No parque não redirecionado, a opção determina o endereço e fornece isso ao TAPI. Em ambos os casos, uma chamada estacionada pode ser desmarcada especificando esse endereço.

A chamada estacionada normalmente entra no estado de chamada ociosa depois de ser estacionada com êxito. O provedor de serviços relata o novo estado usando uma mensagem LINE_CALLSTATE . Uma TSPI_lineUnpark subsequente cria um novo identificador de chamada distinto, independentemente de TSPI_lineCloseCall ter destruído o identificador antigo.

Algumas opções podem lembrar o usuário depois que uma chamada estiver estacionada por um longo período de tempo. O provedor de serviços relata isso ao TAPI como uma chamada de oferta com um motivo de chamada definido como lembrete (se isso for conhecido).