Função lineGetAddressCaps (tapi.h)

Artigo
03/02/2024

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

Sintaxe

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

Parâmetros

hLineApp

Manipule para 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 entre as 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 baixa ordem 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 baixa ordem 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 membro dwTotalSize dessa estrutura para indicar a quantidade de memória disponível para TAPI para retornar informações.

Nota 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 de alocação de memória .

Retornar valor

Retornará zero se a solicitação for bem-sucedida ou um número de erro negativo se ocorrer um erro. Os valores retornados possíveis 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.

Comentários

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 por lineGetDevCaps.