Função lineGetAddressID (tapi.h)

Artigo
03/02/2024

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.