MÉTHODE ITTAPI ::SetApplicationPriority (tapi3if.h)

Article
03/04/2024

La méthode SetApplicationPriority permet à une application de définir sa priorité dans la liste des priorités de transfert pour un type de média particulier ou un mode de demande de téléphonie assistée, ou de se supprimer de la liste des priorités.

Syntaxe

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

Paramètres

[in] pAppFilename

Pointeur vers BSTR contenant le nom de l’application.

[in] lMediaType

Média associé à l’application.

[in] fPriority

Nouvelle priorité pour l’application. Si la valeur VARIANT_FALSE est passée, l’application est supprimée de la liste des priorités pour le média ou le mode de requête spécifié (si elle n’était pas déjà présente, aucune erreur n’est générée). Si la valeur VARIANT_TRUE est passée, l’application est insérée en tant qu’application de priorité la plus élevée pour le média ou le mode de requête (et supprimée d’une position de priorité inférieure, si elle se trouvait déjà dans la liste).

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	La méthode a réussi.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération.

Remarques

L’application doit utiliser SysAllocString pour allouer de la mémoire au paramètre pAppFilename et utiliser SysFreeString pour libérer la mémoire lorsque la variable n’est plus nécessaire.

Les priorités définies avec SetApplicationPriority sont conservées pendant les redémarrages du système ou les redémarrages de tapisrv. La fonction ITTAPI ::RegisterCallNotifications ouvre la ligne sans priorité d’appel spécifiée. Par défaut, l’application de priorité la plus élevée est celle qui a d’abord appelé ITTAPI ::RegisterCallNotifications.