fonction lineRegisterRequestRecipient (tapi.h)

Article
03/13/2024

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.