fonction lineRegisterRequestRecipient (tapi.h)
La fonction lineRegisterRequestRecipient inscrit l’application appelante en tant que destinataire des demandes pour le mode de requête spécifié.
Syntaxe
LONG lineRegisterRequestRecipient(
HLINEAPP hLineApp,
DWORD dwRegistrationInstance,
DWORD dwRequestMode,
DWORD bEnable
);
Paramètres
hLineApp
Handle d’utilisation de l’application pour la partie ligne de TAPI.
dwRegistrationInstance
DWORD spécifique à l’application qui est repassé en tant que paramètre du message LINE_REQUEST. Ce message avertit l’application qu’une demande est en attente. Ce paramètre est ignoré si bEnable est défini sur zéro. Ce paramètre est examiné par TAPI uniquement pour l’inscription, et non pour la désinscription. La valeur dwRegistrationInstance utilisée lors de la désinscription n’a pas besoin de correspondre à dwRegistrationInstance utilisée lors de l’inscription d’un mode de requête.
dwRequestMode
Type de demande pour laquelle l’application s’inscrit. Ce paramètre utilise une ou plusieurs constantes LINEREQUESTMODE_.
bEnable
Si la valeur est TRUE, l’application inscrit les modes de requête spécifiés ; si la valeur est FALSE, l’application annule l’inscription pour les modes de requête spécifiés.
Valeur retournée
Retourne zéro si la demande réussit ou un nombre d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :
LINEERR_INVALAPPHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALREQUESTMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.
Remarques
Une application avec téléphonie peut demander qu’un appel soit passé en son nom en appelant tapiRequestMakeCall. En outre, d’autres applications peuvent demander que les informations soient enregistrées avec un appel donné. Les requêtes tapiRequestMakeCall sont mises en file d’attente par TAPI, et l’application de priorité la plus élevée qui s’est inscrite pour gérer la demande reçoit un message LINE_REQUEST avec une indication du mode de la demande en attente. Cette application est généralement l’application de contrôle d’appel de l’utilisateur.
Ensuite, l’application de contrôle d’appel qui reçoit ce message appelle lineGetRequest, en spécifiant le mode de requête et une mémoire tampon suffisamment grande pour contenir la demande. L’application de contrôle d’appel interprète et exécute ensuite la requête.
L’application destinataire est également automatiquement désinscrite pour toutes les demandes lorsqu’elle effectue un lineShutdown.
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Windows |
En-tête | tapi.h |
Bibliothèque | Tapi32.lib |
DLL | Tapi32.dll |
Voir aussi
Informations de référence sur les services de téléphonie de base