Partager via


Set_Processing_Mode (CPI-C)

L’appel Set_Processing_Mode (nom de fonction cmspm) spécifie pour la conversation si les appels suivants seront retournés lorsque l’opération demandée est terminée (bloquante) ou immédiatement après l’lancement de l’opération (non-blocage).

Remarque

Un programme est averti de l’achèvement des appels non bloquants lorsqu’il émet 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 bloquants 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 retournent immédiatement une fois l’opération lancée.

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

Modifications d’état

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

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