Compartilhar via


Método ITTAPI::SetApplicationPriority (tapi3if.h)

O método SetApplicationPriority 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

HRESULT SetApplicationPriority(
  [in] BSTR         pAppFilename,
  [in] long         lMediaType,
  [in] VARIANT_BOOL fPriority
);

Parâmetros

[in] pAppFilename

Ponteiro para BSTR que contém o nome do aplicativo.

[in] lMediaType

Mídia associada ao aplicativo.

[in] fPriority

A nova prioridade para o aplicativo. Se o valor VARIANT_FALSE for passado, o aplicativo será removido da lista de prioridades para o modo de mídia ou solicitação especificado (se ele já não estiver presente, nenhum erro será gerado). Se o valor VARIANT_TRUE for passado, o aplicativo será inserido como o aplicativo de prioridade mais alta para o modo de mídia ou solicitação (e removido de uma posição de prioridade mais baixa, se já estivesse na lista).

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
O método foi bem-sucedido.
E_OUTOFMEMORY
Há memória insuficiente para executar a operação.

Comentários

O aplicativo deve usar SysAllocString para alocar memória para o parâmetro pAppFilename e usar SysFreeString para liberar a memória quando a variável não for mais necessária.

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

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tapi3if.h (inclua Tapi3.h)
Biblioteca Uuid.lib
DLL Tapi3.dll

Confira também

ITBasicCallControl::HandoffIndirect

ITTAPI

Objeto TAPI