Set_Processing_Mode (CPI-C)

  • Article

L’appel Set_Processing_Mode (nom de la fonction 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 bloquant).

Notes

Un programme est averti de la fin des appels non bloquants lorsqu’il émet des Wait_For_Conversation ou via un message Microsoft® Windows® envoyé à un WndProc identifié par le hWnd dans l’appel Specify_Windows_Handle .

Syntaxe

  
CM_ENTRY Set_Processing_Mode(   
  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 si les appels suivants sur la conversation seront bloqués ou non bloquants. Les valeurs possibles sont les suivantes :

CM_BLOCKING
Les appels suivants ne retournent que lorsque l’opération est terminée.

CM_NON_BLOCKING
Les appels suivants seront retournés immédiatement après le lancement de l’opération.

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_STATE_CHECK
Code de retour principal ; l’opération incomplète précédente sur la conversation n’est pas encore terminée.

CM_PROGRAM_PARAMETER_CHECK
Code de retour principal ; la valeur spécifiée par conversation_ID ou processing_mode 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.