função TSPI_lineGetAddressID (tspi.h)

  • Artigo

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

Sintaxe

LONG TSPIAPI TSPI_lineGetAddressID(
  HDRVLINE hdLine,
  LPDWORD  lpdwAddressID,
  DWORD    dwAddressMode,
  LPCWSTR  lpsAddress,
  DWORD    dwSize
);

Parâmetros

hdLine

O identificador do provedor de serviços para a linha cujo endereço deve ser recuperado.

lpdwAddressID

Um ponteiro para um local de memória do tamanho DWORD em que o identificador de endereço é retornado.

dwAddressMode

O modo de endereço do endereço contido em lpsAddress. O parâmetro dwAddressMode tem permissão para ter apenas uma das constantes LINEADDRESSMODE_.

lpsAddress

Um 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 pelo parâmetro dwAddressMode . Se for LINEADDRESSMODE_DIALABLEADDR, o parâmetro lpsAddress usará o formato de número discável comum e será encerrado em NULL .

dwSize

O tamanho do endereço contido em lpsAddress. O parâmetro dwSize deverá ser definido como o comprimento da cadeia de caracteres (mais um para NULL) se LINEADDRESSMODE_DIALABLEADDR for usado. Se um LINEADDRESSMODE estendido for usado, o comprimento deverá corresponder ao tamanho do que é realmente passado (a DLL verifica se pode ler o número de bytes especificado do ponteiro fornecido).

Valor retornado

Retornará zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os valores retornados possíveis são os seguintes:

LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESS, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Comentários

Essa função é usada para mapear um número de telefone (endereço) atribuído a um dispositivo de linha de volta para seu dwAddressID (no intervalo de 0 até o número de endereços menos um) que é retornado nos recursos do dispositivo da linha.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho tspi.h

Confira também

Constantes LINEADDRESSMODE_