Função lineSetAppPriority (tapi.h)

Artigo
08/26/2023

A função lineSetAppPriority permite que um aplicativo defina sua prioridade na lista de prioridades de entrega para um tipo de mídia específico ou modo de solicitação de telefonia assistida ou remova-se da lista de prioridades.

Sintaxe

LONG lineSetAppPriority(
  LPCSTR            lpszAppFilename,
  DWORD             dwMediaMode,
  LPLINEEXTENSIONID lpExtensionID,
  DWORD             dwRequestMode,
  LPCSTR            lpszExtensionName,
  DWORD             dwPriority
);

Parâmetros

lpszAppFilename

Um ponteiro para uma cadeia de caracteres que contém o nome do arquivo do módulo executável do aplicativo, sem os dados do diretório. No TAPI versão 2.0 ou posterior, o parâmetro pode especificar um nome de arquivo no formato de nome de arquivo longo ou 8.3.

dwMediaMode

Um tipo de mídia para o qual a prioridade do aplicativo deve ser definida. O valor pode ser uma ou mais das constantes LINEMEDIAMODE . O valor zero deve ser usado para definir a prioridade do aplicativo para solicitações de telefonia assistida.

lpExtensionID

Um ponteiro para uma estrutura do tipo LINEEXTENSIONID. Este parâmetro é ignorado.

dwRequestMode

As condições para esse parâmetro são, se o parâmetro dwMediaMode for zero, esse parâmetro especificará o modo de solicitação de telefonia assistida para o qual a prioridade deve ser definida. Deve ser LINEREQUESTMODE_MAKECALL. Esse parâmetro será ignorado se dwMediaMode não for zero.

lpszExtensionName

Este parâmetro é ignorado.

dwPriority

Um parâmetro que indica uma nova prioridade para o aplicativo. Se o valor 0 for passado, o aplicativo será removido da lista de prioridades para o modo de mídia ou solicitação especificado; se ele ainda não estava presente, nenhum erro será gerado. Se o valor 1 for passado, o aplicativo será inserido como o aplicativo de prioridade mais alta para o modo de mídia ou solicitação; ele será removido de uma posição de prioridade mais baixa, se já estiver na lista. Qualquer outro valor gera um erro.

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_INIFILECORRUPT, LINEERR_INVALREQUESTMODE, LINEERR_INVALAPPNAME, LINEERR_NOMEM, LINEERR_INVALMEDIAMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPARAM, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER.

Comentários

Se LINEERR_INVALMEDIAMODE for retornado, o valor especificado em dwMediaMode não será zero e não uma das constantes LINEMEDIAMODE_.

Essa função atualiza a lista de prioridades armazenadas. Se o sistema de telefonia for inicializado, ele também definirá as prioridades atuais e ativas para aplicativos em execução; a nova prioridade é usada na próxima chamada de entrada ou lineHandoff com base no tipo de mídia.

As Prioridades definidas com lineSetAppPriority persistirão entre reinicializações do sistema ou reinicializações do tapisrv. A função lineOpen abre a linha sem prioridades de chamada especificadas. Por padrão, o aplicativo de prioridade mais alta será aquele que primeiro chamou lineOpen.