Set_Receive_Type (CPI-C)

L’appel Set_Receive_Type (nom de fonction cmsrt) spécifie la façon dont le programme recevra des données sur les 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 lorsque l’appel de réception est émis.

La valeur de type de réception affecte tous les appels de réception suivants. Elle peut être modifiée en réédition 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 à partir 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 à partir du programme partenaire. Si aucune donnée n’est disponible, le programme local n’attend pas.

return_code
Code retourné à partir de 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.

Modifications d’état

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

Il n’y a aucune modification d’état.