Função lineUnpark (tapi.h)

  • Artigo

A função lineUnpark recupera a chamada estacionada no endereço especificado e retorna um identificador de chamada para ela.

Sintaxe

LONG lineUnpark(
  HLINE   hLine,
  DWORD   dwAddressID,
  LPHCALL lphCall,
  LPCSTR  lpszDestAddress
);

Parâmetros

hLine

Identificador para o dispositivo de linha aberta no qual uma chamada deve ser desmarque.

dwAddressID

Endereço em hLine no qual o unpark deve ser originado. Um identificador de endereço está permanentemente associado a um endereço; o identificador permanece constante entre as atualizações do sistema operacional.

lphCall

Ponteiro para o local do tipo HCALL em que o identificador para a chamada não indexada é retornado. Esse identificador não está relacionado a qualquer outro identificador que possa ter sido anteriormente associado à chamada recuperada, como o identificador que pode ter sido associado à chamada quando ela estava estacionada originalmente. O aplicativo é o único proprietário inicial dessa chamada.

lpszDestAddress

Ponteiro para um buffer de caracteres terminado em nulo que contém o endereço em que a chamada está estacionada. O endereço está no formato de endereço discável padrão.

Retornar valor

Retorna um identificador de solicitação positivo se a função for concluída de forma assíncrona ou um número de erro negativo se ocorrer um erro. O parâmetro dwParam2 da mensagem de LINE_REPLY correspondente será zero se a função for bem-sucedida ou se for um número de erro negativo se ocorrer um erro. Os valores retornados possíveis são:

LINEERR_INVALADDRESS, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tapi.h
Biblioteca Tapi32.lib
DLL Tapi32.dll

Confira também

LINE_REPLY

Funções de serviço de linha suplementar

Visão geral da referência do TAPI 2.2