Função lineGetAddressCapsA (tapi.h)

A função lineGetAddressCaps consulta o endereço especificado no dispositivo de linha especificado para determinar seus recursos de telefonia.

Sintaxe

LONG lineGetAddressCapsA(
  HLINEAPP          hLineApp,
  DWORD             dwDeviceID,
  DWORD             dwAddressID,
  DWORD             dwAPIVersion,
  DWORD             dwExtVersion,
  LPLINEADDRESSCAPS lpAddressCaps
);

Parâmetros

hLineApp

Manipule o registro do aplicativo com TAPI.

dwDeviceID

Dispositivo de linha que contém o endereço a ser consultado.

dwAddressID

Endereço no dispositivo de linha determinado cujos recursos devem ser consultados. Um identificador de endereço está permanentemente associado a um endereço; o identificador permanece constante em atualizações do sistema operacional.

dwAPIVersion

Número de versão da API de Telefonia a ser usada. A palavra de alta ordem contém o número de versão principal; a palavra de ordem baixa contém o número de versão secundária. Esse número é obtido por lineNegotiateAPIVersion.

dwExtVersion

Número de versão das extensões específicas do provedor de serviços a serem usadas. Esse número poderá ser definido como zero se nenhuma extensão específica do dispositivo for usada. Caso contrário, a palavra de alta ordem contém o número de versão principal; e a palavra de ordem baixa contém o número de versão secundária.

lpAddressCaps

Ponteiro para uma estrutura de tamanho variavelmente do tipo LINEADDRESSCAPS . Após a conclusão bem-sucedida da solicitação, essa estrutura é preenchida com informações de funcionalidades de endereço. Antes de chamar lineGetAddressCaps, o aplicativo deve definir o dwTotalSize membro dessa estrutura para indicar a quantidade de memória disponível para TAPI para retornar informações.

Observação Se os parâmetros de tamanho na estrutura não estiverem corretos, há a possibilidade de que os dados possam ser substituídos. Para obter mais informações sobre como definir tamanhos de estrutura, consulte o tópico alocação de memória.

 

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_BADDEVICEID, LINEERR_NOMEM, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONFAILED, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALAPPHANDLE, LINEERR_UNINITIALIZED, LINEERR_INVALPOINTER, LINEERR_OPERATIONUNAVAIL, LINEERR_NODRIVER, LINEERR_NODEVICE.

Observações

Os identificadores de endereço válidos variam de zero a um a menos do que o número de endereços retornados por lineGetDevCaps. O número de versão a ser fornecido é o número de versão que foi retornado como parte dos recursos de dispositivo da linha lineGetDevCaps.

Nota

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

LINEADDRESSCAPS

visão geral de referência do TAPI 2.2

lineGetDevCaps

lineNegotiateAPIVersion