Função lineGetStatusMessages (tapi.h)

Artigo
03/02/2024

A função lineGetStatusMessages permite que um aplicativo consulte quais mensagens de notificação o aplicativo está configurado para receber eventos relacionados a status alterações para a linha especificada ou qualquer um de seus endereços.

Sintaxe

LONG lineGetStatusMessages(
  HLINE   hLine,
  LPDWORD lpdwLineStates,
  LPDWORD lpdwAddressStates
);

Parâmetros

hLine

Manipule para o dispositivo de linha.

lpdwLineStates

A matriz de bits que identifica para qual dispositivo de linha status altera uma mensagem deve ser enviada ao aplicativo. Se um sinalizador for TRUE, essa mensagem estará habilitada; se FALSE, ele será desabilitado. Esse parâmetro usa uma ou mais constantes de LINEDEVSTATE_.

lpdwAddressStates

A matriz de bits que identifica para qual endereço status altera uma mensagem deve ser enviada ao aplicativo. Se um sinalizador for TRUE, essa mensagem estará habilitada; se FALSE, desabilitado. Esse parâmetro usa uma ou mais constantes de LINEADDRESSSTATE_.

Retornar valor

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_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM LINEERR_UNINITIALIZED.

Comentários

O TAPI define várias mensagens que notificam aplicativos sobre eventos que ocorrem em linhas e endereços. Um aplicativo pode não estar interessado em receber todos os endereços e linhas status alterar mensagens. A função lineSetStatusMessages pode ser usada para selecionar quais mensagens o aplicativo deseja receber. Por padrão, os relatórios de status de endereço e status de linha estão desabilitados.