Set_Receive_Type (CPI-C)

  • Article

L’appel Set_Receive_Type (nom de fonction cmsrt) spécifie comment le programme recevra les données lors des appels de réception suivants. Il remplace le type de réception par défaut établi par l’appel Initialize_Conversation ou Accept_Conversation . Par défaut, le programme attend que les données arrivent si elles ne sont pas disponibles lors de l’émission de l’appel de réception .

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.

Syntaxe

  
CM_ENTRY Set_Receive_Type(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *receive_type,            
  CM_INT32 FAR *return_code              
);

Paramètres

conversation_ID
Paramètre fourni. Spécifie l’identificateur de la conversation. La valeur de ce paramètre a été retournée par Initialize_Conversation ou Accept_Conversation.

receive_type
Paramètre fourni. Spécifie la façon dont les données doivent être reçues par le programme lors des appels de réception suivants. Les valeurs possibles sont les suivantes :

CM_RECEIVE_AND_WAIT
Le programme local reçoit toutes les données actuellement disponibles du programme partenaire. Si aucune donnée n’est disponible, le programme local attend que les données arrivent.

CM_RECEIVE_IMMEDIATE
Le programme local reçoit toutes les données actuellement disponibles du programme partenaire. Si aucune donnée n’est disponible, le programme local n’attend pas.

return_code
Code retourné par cet appel. Les codes de retour valides sont répertoriés plus loin dans cette rubrique.

Codes de retour

CM_OK
Code de retour principal ; l’appel a été exécuté avec succès.

CM_PROGRAM_PARAMETER_CHECK
Code de retour principal ; la valeur spécifiée par conversation_ID ou receive_type n’est pas valide, ou l’adresse d’une variable n’est pas valide.

CM_PRODUCT_SPECIFIC_ERROR
Code de retour principal ; une erreur spécifique au produit s’est produite et a été enregistrée dans le journal des erreurs des produits.

Changements d'état

La conversation peut être dans n’importe quel état à l’exception de RESET.

Il n’y a aucun changement d’état.