Função lineSetStatusMessages (tapi.h)

Artigo
03/02/2024

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

Sintaxe

LONG lineSetStatusMessages(
  HLINE hLine,
  DWORD dwLineStates,
  DWORD dwAddressStates
);

Parâmetros

hLine

Identificador para o dispositivo de linha.

dwLineStates

A matriz de bits que identifica para qual dispositivo de linha status altera uma mensagem deve ser enviada ao aplicativo. Esse parâmetro usa uma ou mais das constantes LINEDEVSTATE_.

dwAddressStates

Matriz de bits que identifica para qual endereço status altera uma mensagem deve ser enviada ao aplicativo. Esse parâmetro usa uma ou mais das constantes LINEADDRESSSTATE_.

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_INVALADDRESSSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALLINESTATE, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_OPERATIONUNAVAIL.

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 todas as mensagens de alteração de endereço e linha status. A função lineSetStatusMessages pode ser usada para selecionar quais mensagens o aplicativo recebe. Por padrão, o relatório de status de endereços e linhas está desabilitado.