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.

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

Confira também

ITBasicCallControl::HandoffIndirect

ITTAPI

Objeto TAPI