Remarque
L’accès à cette page requiert une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page requiert une autorisation. Vous pouvez essayer de modifier des répertoires.
La fonction lineSetAppPriority
Syntaxe
LONG lineSetAppPriorityW(
LPCWSTR lpszAppFilename,
DWORD dwMediaMode,
LPLINEEXTENSIONID lpExtensionID,
DWORD dwRequestMode,
LPCWSTR lpszExtensionName,
DWORD dwPriority
);
Paramètres
lpszAppFilename
Pointeur vers une chaîne qui contient le nom de fichier du module exécutable de l’application, sans les données du répertoire. Dans TAPI version 2.0 ou ultérieure, le paramètre peut spécifier un nom de fichier au format de nom de fichier long ou 8.3.
dwMediaMode
Type de média pour lequel la priorité de l’application doit être définie. La valeur peut être une ou plusieurs des constantes LINEMEDIAMODE. La valeur zéro doit être utilisée pour définir la priorité de l’application pour les demandes de téléphonie assistée.
lpExtensionID
Pointeur vers une structure de type LINEEXTENSIONID. Ce paramètre est ignoré.
dwRequestMode
Les conditions de ce paramètre sont, si le paramètre dwMediaMode est égal à zéro, ce paramètre spécifie le mode de demande de téléphonie assistée pour lequel la priorité doit être définie. Il doit être LINEREQUESTMODE_MAKECALL. Ce paramètre est ignoré si dwMediaMode n’est pas zéro.
lpszExtensionName
Ce paramètre est ignoré.
dwPriority
Paramètre qui indique une nouvelle priorité pour l’application. Si la valeur 0 est passée, l’application est supprimée de la liste de priorité pour le média ou le mode de requête spécifié ; s’il n’était pas déjà présent, aucune erreur n’est générée. Si la valeur 1 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 demande ; elle est supprimée d’une position de priorité inférieure, si elle figure déjà dans la liste. Toute autre valeur génère une erreur.
Valeur de retour
Retourne zéro si la requête réussit ou si un numéro d’erreur négatif se produit. Les valeurs de retour possibles sont les suivantes :
LINEERR_INIFILECORRUPT, LINEERR_INVALREQUESTMODE, LINEERR_INVALAPPNAME, LINEERR_NOMEM, LINEERR_INVALMEDIAMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPARAM, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER.
Remarques
Si LINEERR_INVALMEDIAMODE est retourné, la valeur spécifiée dans dwMediaMode n’est pas zéro et non l’une des constantes LINEMEDIAMODE_.
Cette fonction met à jour la liste de priorité stockée. Si le système de téléphonie est initialisé, il définit également les priorités actuelles et actives pour les applications en cours d’exécution ; la nouvelle priorité est utilisée sur le prochain appel entrant ou lineHandoff en fonction du type de média.
Les priorités définies avec lineSetAppPriority persistent entre les redémarrages du système ou les redémarrages de tapisrv. La fonction lineOpen ouvre la ligne sans priorités d’appel spécifiées. Par défaut, l’application de priorité la plus élevée est celle qui a d’abord appelé lineOpen.
Note
L’en-tête tapi.h définit lineSetAppPriority comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Windows |
| d’en-tête | tapi.h |
| bibliothèque | Tapi32.lib |
| DLL | Tapi32.dll |
Voir aussi
fonctions de service de ligne supplémentaires