fonction phoneSetData (tapi.h)

  • Article

La fonction phoneSetData télécharge les informations contenues dans la mémoire tampon spécifiée sur l’appareil téléphonique ouvert à l’identificateur de données sélectionné.

Syntaxe

LONG phoneSetData(
  HPHONE       hPhone,
  DWORD        dwDataID,
  LPVOID const lpData,
  DWORD        dwSize
);

Paramètres

hPhone

Gérez l’appareil téléphonique ouvert. L’application doit être le propriétaire du téléphone.

dwDataID

Où, dans l’appareil téléphonique, la mémoire tampon doit être téléchargée.

lpData

Pointeur vers l’emplacement de mémoire à partir duquel les données doivent être téléchargées.

dwSize

Taille de la mémoire tampon, en octets.

Valeur retournée

Retourne un identificateur de requête positif si la fonction est terminée de manière asynchrone ou un numéro d’erreur négatif si une erreur se produit. Le paramètre dwParam2 du message PHONE_REPLY correspondant est égal à zéro si la fonction réussit ou s’il s’agit d’un numéro d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOTOWNER, PHONEERR_NOMEM, PHONEERR_INVALDATAID, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPOINTER, PHONEERR_UNINITIALIZED.

Remarques

La fonction phoneSetData télécharge un maximum d’octets dwSize de lpData sur l’appareil téléphonique. Le format des données, leur signification pour l’appareil téléphonique et la signification de l’identificateur de données sont spécifiques au fournisseur de services. Les données dans la mémoire tampon ou la sélection d’un identificateur de données peuvent servir de commandes à l’appareil téléphonique.

Configuration requise

   
Plateforme cible Windows
En-tête tapi.h
Bibliothèque Tapi32.lib
DLL Tapi32.dll

Voir aussi

PHONE_REPLY

Fonctions de service téléphonique supplémentaires

Vue d’ensemble de la référence TAPI 2.2