Função lineUnparkA (tapi.h)

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

Sintaxe

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

Parâmetros

hLine

Manipule para o dispositivo de linha aberta no qual uma chamada deve ser descomparnada.

dwAddressID

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

lphCall

Ponteiro para o local do tipo HCALL em que o identificador para a chamada não localizada é retornado. Esse identificador não está relacionado a qualquer outro identificador que possa ter sido anteriormente associado à chamada recuperada, como o identificador que poderia 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 encerrado 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.

Valor de retorno

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 LINE_REPLY correspondente é zero se a função for bem-sucedida ou se for um número de erro negativo se ocorrer um erro. Os possíveis valores retornados são:

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

Observações

Nota

O cabeçalho tapi.h define lineUnpark como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
da Plataforma de Destino	Windows
cabeçalho	tapi.h
biblioteca	Tapi32.lib
de DLL	Tapi32.dll

Consulte também

LINE_REPLY

Funções de serviço de linha suplementar

visão geral de referência do TAPI 2.2