Compartilhar via


Função lineGetAddressID (tapi.h)

A função lineGetAddressID retorna o identificador de endereço associado a um endereço em um formato diferente na linha especificada.

Sintaxe

LONG lineGetAddressID(
  HLINE   hLine,
  LPDWORD lpdwAddressID,
  DWORD   dwAddressMode,
  LPCSTR  lpsAddress,
  DWORD   dwSize
);

Parâmetros

hLine

Manipule para o dispositivo de linha aberta.

lpdwAddressID

Ponteiro para um local de memória do tamanho DWORD em que o identificador de endereço é retornado. Um identificador de endereço está permanentemente associado a um endereço; o identificador permanece constante entre as atualizações do sistema operacional.

dwAddressMode

Modo de endereço do endereço contido em lpsAddress. Esse parâmetro usa uma e apenas uma das constantes LINEADDRESSMODE_. Você deve especificar LINEADDRESSMODE_DIALABLEADDR.

lpsAddress

Ponteiro para uma estrutura de dados que contém o endereço atribuído ao dispositivo de linha especificado. O formato do endereço é determinado por dwAddressMode. Como o único valor válido é LINEADDRESSMODE_DIALABLEADDR, lpsAddress usa o formato de número discável comum e é encerrado em nulo.

dwSize

Tamanho, em bytes, do endereço contido em lpsAddress. O tamanho da cadeia de caracteres deve incluir o terminador nulo.

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_INVALLINEHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALADDRESS, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Comentários

A função lineGetAddressID é usada para mapear um número de telefone (endereço) atribuído a um dispositivo de linha de volta à sua dwAddressID no intervalo zero para o número de endereços menos um retornado nos recursos do dispositivo da linha. A função lineMakeCall permite que o aplicativo faça uma chamada especificando um identificador de linha e um endereço na linha. O endereço pode ser especificado como dwAddressID, como um número de telefone ou como um nome ou identificador específico do dispositivo. O uso de um número de telefone pode ser prático em ambientes em que uma única linha recebe vários endereços.

Nota LINEADDRESSMODE_ADDRESSID não pode ser usado com lineGetAddressID.
 

Requisitos

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

Confira também

Referência básica dos Serviços de Telefonia

Visão geral da referência do TAPI 2.2

Linemakecall