função TSPI_lineGetAddressID (tspi.h)
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 |