Função lineGetAddressStatus (tapi.h)

Artigo
03/05/2024

A função lineGetAddressStatus permite que um aplicativo consulte o endereço especificado para seu status atual.

Sintaxe

LONG lineGetAddressStatus(
  HLINE               hLine,
  DWORD               dwAddressID,
  LPLINEADDRESSSTATUS lpAddressStatus
);

Parâmetros

hLine

Identificador para o dispositivo de linha aberta.

dwAddressID

Endereço no dispositivo de linha aberta especificado. Esse é o endereço a ser consultado. Um identificador de endereço está permanentemente associado a um endereço; o identificador permanece constante entre as atualizações do sistema operacional.

lpAddressStatus

Ponteiro para uma estrutura de dados de tamanho variavelmente do tipo LINEADDRESSSTATUS. Antes de chamar lineGetAddressStatus, 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_INVALADDRESSID, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_OPERATIONUNAVAIL, LINEERR_OPERATIONFAILED.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	tapi.h
Biblioteca	Tapi32.lib
DLL	Tapi32.dll

Confira também

Referência básica dos Serviços de Telefonia

LINEADDRESSSTATUS

Visão geral da referência do TAPI 2.2

Compartilhar via