Réception de données
Les appels ou extensions suivants permettent à un programme de recevoir des données de son programme partenaire :
Notes
Les noms des appels sont des pseudonymes. Les noms de fonction C réels apparaissent entre parenthèses après les pseudonymes. Par exemple, Accept_Conversation est le pseudonyme d’un appel. Le nom réel de la fonction est cmaccp.
Receive( cmrcv)
L’émission de cet appel alors que la conversation est à l’état RECEIVE fait que le programme local reçoit toutes les données actuellement disponibles à partir du programme partenaire. Si aucune donnée n’est disponible et que le type de réception est défini sur CM_RECEIVE _AND_WAIT, le programme local attend que les données arrivent. Si le type de réception est défini sur CM_RECEIVE_IMMEDIATE, le programme n’attend pas.
L’émission de cet appel lorsque la conversation est à l’état SEND ou SEND_PENDING n’est autorisée que si le type de réception est défini sur CM_RECEIVE_AND_WAIT. Cela vide la mémoire tampon d’envoi de l’unité logique (LU) et modifie l’état de la conversation sur RECEIVE. Le programme local commence alors à recevoir des données.
Set_Fill( cmsf)
Utilisé dans une conversation de base, cet appel définit le type de remplissage de la conversation, qui spécifie si les programmes recevront des données sous la forme d’enregistrements logiques ou sous la forme d’une longueur de données spécifiée. Cet appel a un effet uniquement dans les conversations de base. La valeur de remplissage affecte tous les appels de réception suivants. Il peut être modifié en rééditant Set_Fill.
Set_Processing_Mode( cmspm)
Spécifie pour la conversation si les appels suivants seront retournés lorsque l’opération demandée est terminée (blocage) ou immédiatement après le lancement de l’opération (non bloquante). Un programme est averti de la fin des appels non bloquants lorsqu’il émet des Wait_For_Conversation ou par le biais d’un message Microsoft Windows envoyé à un WndProc identifié par le paramètre hwndNotify dans Specify_Windows_Handle.
Set_Receive_Type( cmsrt)
Définit le type de réception de la conversation, qui spécifie si un programme qui émet un appel de réception attend que les données arrivent si les données ne sont pas disponibles. La valeur du type de réception affecte tous les appels de réception suivants. Il peut être modifié en rééditant Set_Receive_Type.
Specify_Windows_Handle( xchwnd)
Définit le handle de fenêtre auquel un message est envoyé à la fin d’une opération en mode non bloquant. Une application peut définir le mode de traitement en appelant Set_Processing_Mode. Si le handle de fenêtre est défini sur NULL ou si cet appel n’est jamais émis, l’application doit appeler Wait_For_Conversation pour être avertie lorsque l’opération en suspens se termine.