fonction phoneSetData (tapi.h)
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 |