Set_Fill (CPI-C)

  • Article

L’appel Set_Fill (nom de la fonction cmsf) 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 est autorisé uniquement dans les conversations de base.

Syntaxe

  
CM_ENTRY Set_Fill(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *fill,                    
  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.

Remplir
Paramètre fourni. Spécifie la forme dans laquelle les programmes recevront des données. Voici quelques choix possibles :

CM_FILL_BUFFER
Le programme local reçoit des données jusqu’à ce que le nombre d’octets spécifié par le paramètre requested_length de l’appel de réception soit atteint ou jusqu’à la fin des données. Les données sont reçues sans tenir compte du format d’enregistrement logique.

CM_FILL_LL
Les données sont reçues au format d’enregistrement logique. Les données reçues peuvent être un enregistrement logique complet, une partie d’un enregistrement logique égale au paramètre requested_length de l’appel receive ou la fin d’un enregistrement logique.

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 ; l’une des opérations suivantes s’est produite :

  • La valeur spécifiée par conversation_ID ou remplissage n’est pas valide.

  • La conversation actuelle est mappée.

    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.

Remarques

Set_Fill remplace le remplissage par défaut établi par Initialize_Conversation ou Accept_Conversation. Le remplissage par défaut est CM_FILL_LL.

La valeur de remplissage affecte tous les appels de réception suivants. Il peut être modifié en réexéditant l’appel Set_Fill .