função TSPI_lineSetStatusMessages (tspi.h)

Artigo
03/13/2024

A função TSPI_lineSetStatusMessages permite que o TAPI especifique quais mensagens de notificação o provedor de serviços deve gerar para eventos relacionados a alterações de status para a linha especificada ou qualquer um de seus endereços.

Sintaxe

LONG TSPIAPI TSPI_lineSetStatusMessages(
  HDRVLINE hdLine,
  DWORD    dwLineStates,
  DWORD    dwAddressStates
);

Parâmetros

hdLine

O identificador para o dispositivo de linha para o qual o novo filtro deve ser definido.

dwLineStates

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

dwAddressStates

Uma matriz de bits que identifica para qual endereço status altera uma mensagem deve ser enviada ao TAPI. Esse parâmetro usa uma das constantes LINEADDRESSSTATE_.

Retornar valor

Retornará zero se a função for bem-sucedida ou um número de erro se ocorrer um erro. Os valores retornados possíveis são os seguintes:

LINEERR_INVALADDRESSSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALLINESTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM.

Comentários

O provedor de serviços retornará LINEERR_INVALLINESTATE se o parâmetro dwLineStates contiver um ou mais bits que não são constantes LINEDEVSTATE_.

A telefonia define várias mensagens que notificam os aplicativos sobre eventos que ocorrem em linhas e endereços. Os conjuntos de todas as mensagens de alteração nos quais todos os aplicativos estão interessados podem ser muito menores do que o conjunto de mensagens possíveis. Esse procedimento permite que a TAPI informe ao provedor de serviços o conjunto reduzido de mensagens a serem entregues. O provedor de serviços fornece todas as mensagens compatíveis, dentro do conjunto especificado. Ele tem permissão para entregar mais (eles são filtrados pelo TAPI), mas é desencorajado a fazê-lo por motivos de desempenho. Se o TAPI solicitar a entrega de um tipo de mensagem específico que não é produzido pelo provedor, o provedor, no entanto, aceitará a solicitação, mas simplesmente não produzirá a mensagem. Por padrão, o relatório de status de endereços e linhas é inicialmente desabilitado para uma linha.

Essa função difere da função TAPI correspondente da seguinte maneira: (1) O conjunto de mensagens solicitadas é a união de todos os conjuntos solicitados por aplicativos no nível tapi. (2) O conjunto de mensagens não é reduzido nem aumentado pela propriedade (porque não há nenhum conceito de propriedade no nível do TSPI) (3) O conjunto é consultivo no sentido de que o provedor de serviços é necessário para encaminhar pelo menos o conjunto indicado de mensagens, mas tem permissão para encaminhar um conjunto maior.

As alterações de estado do dispositivo em relação a Abrir e Fechar não são relatadas, pois no nível do TSPI há apenas um Open pendente por vez.