Função lineGetAddressIDW (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 lineGetAddressIDW(
  HLINE   hLine,
  LPDWORD lpdwAddressID,
  DWORD   dwAddressMode,
  LPCWSTR lpsAddress,
  DWORD   dwSize
);

Parâmetros

hLine

Manipule para o dispositivo de linha aberta.

lpdwAddressID

Ponteiro para um DWORDlocal de memória do tamanho do endereço em que o identificador de endereço é retornado. Um identificador de endereço está permanentemente associado a um endereço; o identificador permanece constante em 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.

Valor de retorno

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.

Observações

A função lineGetAddressID é usada para mapear um número de telefone (endereço) atribuído a um dispositivo de linha de volta à 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 um 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.

Observação LINEADDRESSMODE_ADDRESSID pode não ser usada com lineGetAddressID.

 

Nota

O cabeçalho tapi.h define lineGetAddressID 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

Referência dos Serviços básicos de telefonia

visão geral de referência do TAPI 2.2

lineMakeCall