Função lineSetStatusMessages (tapi.h)
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.
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