Set_Processing_Mode (CPI-C)

La chiamata Set_Processing_Mode ( nome funzione cmspm) specifica per la conversazione se le chiamate successive verranno restituite quando l'operazione richiesta viene completata (blocco) o immediatamente dopo l'avvio dell'operazione (nonblocking).

Nota

Un programma riceve una notifica del completamento delle chiamate non sbloccanti quando genera Wait_For_Conversation o tramite un messaggio di Microsoft® Windows® inviato a un WndProc identificato dall'hWndnella chiamata Specify_Windows_Handle.

Sintassi

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

Parametri

conversation_ID
Parametro fornito. Specifica l'identificatore per la conversazione. Il valore di questo parametro è stato restituito da Initialize_Conversation o Accept_Conversation.

receive_type
Parametro fornito. Specifica se le chiamate successive nella conversazione verranno bloccate o non bloccate. I valori possibili sono:

CM_BLOCKING
Le chiamate successive restituiranno solo al termine dell'operazione.

CM_NON_BLOCKING
Le chiamate successive restituiranno immediatamente dopo l'avvio dell'operazione.

return_code
Codice restituito da questa chiamata. I codici restituiti validi sono elencati più avanti in questo argomento.

Codici restituiti

CM_OK
Codice restituito primario; la chiamata eseguita correttamente.

CM_PROGRAM_STATE_CHECK
Codice restituito primario; l'operazione incompleta precedente nella conversazione non è ancora stata completata.

CM_PROGRAM_PARAMETER_CHECK
Codice restituito primario; il valore specificato da conversation_ID o processing_mode non è valido.

CM_PRODUCT_SPECIFIC_ERROR
Codice restituito primario; si è verificato un errore specifico del prodotto ed è stato registrato nel log degli errori dei prodotti.

Modifiche di stato

La conversazione può essere in qualsiasi stato tranne RESET.

Non esiste alcuna modifica dello stato.