lineGetAddressID

9/19/2008

Essa função retorna o identificador endereço associado com um endereço em um formato diferente na linha especificada.

Syntax

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

Parameters

• hLine
  Identificador para o aberto dispositivo de linha.

• lpdwAddressID
  Ponteiro para um DWORD-Tamanho localidade memória onde o identificador endereço é retornado. Um identificador endereço permanentemente é associado com um endereço; o identificador permanece constante entre atualizações sistema operacional.

• dwAddressMode
  Modo de endereço de endereço contido lpsAddress. Este parâmetro usa um e apenas um do LINEADDRESSMODE Constantes. Você deve especificar LINEADDRESSMODE_DIALABLEADDR.

• lpsAddress
  Ponteiro para uma estrutura de dados mantendo o endereço atribuído ao dispositivo de linha especificado. O formato do endereço é determinado pelo dwAddressMode. Porque o válido somente valor é LINEADDRESSMODE_DIALABLEADDR, lpsAddress Usa o comum discável formato número e é terminada por caractere nulo.

• dwSize
  Tamanho, em bytes, do endereço contidas lpsAddress. O tamanho do seqüência de caracteres deve incluir o NULL terminador.

Return Value

Retorna zero se a solicitação for bem-sucedido ou um número negativo erro se ocorrer um erro. A seguinte tabela mostra os valores de retorno para esta função.

Valor	Descrição
LINEERR_INVALLINEHANDLE	O identificador para o aberto linha dispositivo é inválido.
LINEERR_OPERATIONUNAVAIL	A operação é não disponível.
LINEERR_INVALADDRESSMODE	O modo endereço é inválido.
LINEERR_OPERATIONFAILED	A operação falhou.
LINEERR_INVALPOINTER	O ponteiro é inválido.
LINEERR_RESOURCEUNAVAIL	Os recursos são não disponível.
LINEERR_INVALADDRESS	O endereço é inválido.
LINEERR_UNINITIALIZED	Um parâmetro é unitialized.
LINEERR_NOMEM	Não há memória o suficiente disponível.

Remarks

O lineGetAddressID função é usada para mapa (n.); mapear (v.) um número de telefone (endereço) atribuído a um dispositivo de linha voltar para sua dwAddressID No intervalo zero para o número de endereços menos um retornados em recursos dispositivo da linha. O lineMakeCall função permite que o aplicativo para tornar um chamar, 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 específico do dispositivo ou identificador. Usar um número de telefone pode ser prático em ambientes onde uma única linha é atribuída múltiplo endereços.

Observação

Essa função é TAPI versão 2.0 e posterior.

Observação

LINEADDRESSMODE_ADDRESSID não pode ser usado com lineGetAddressID.

Requirements

Header	tapi.h
Library	coredll.lib
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

lineMakeCall