MÉTHODE ITTAPI ::SetApplicationPriority (tapi3if.h)
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 |
|---|---|
|
La méthode a réussi. |
|
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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tapi3if.h (inclure Tapi3.h) |
| Bibliothèque | Uuid.lib |
| DLL | Tapi3.dll |