Set_Receive_Type (CPI-C)

  • Articolo

La chiamata Set_Receive_Type (nome funzione cmsrt) specifica come il programma riceverà i dati sulle chiamate di ricezione successive. Esegue l'override del tipo di ricezione predefinito stabilito dalla chiamata Initialize_Conversation o Accept_Conversation . Per impostazione predefinita, il programma attende l'arrivo dei dati se non è disponibile quando viene emessa la chiamata di ricezione .

Il valore del tipo di ricezione influisce su tutte le chiamate di ricezione successive. Può essere modificato ripubblicando Set_Receive_Type.

Sintassi

  
CM_ENTRY Set_Receive_Type(   
  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 il modo in cui i dati devono essere ricevuti dal programma nelle chiamate di ricezione successive. I valori possibili sono:

CM_RECEIVE_AND_WAIT
Il programma locale riceve tutti i dati attualmente disponibili dal programma partner. Se non sono disponibili dati, il programma locale attende l'arrivo dei dati.

CM_RECEIVE_IMMEDIATE
Il programma locale riceve tutti i dati attualmente disponibili dal programma partner. Se non sono disponibili dati, il programma locale non attende.

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_PARAMETER_CHECK
Codice restituito primario; il valore specificato da conversation_ID o receive_type non è valido oppure l'indirizzo di una variabile 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.