Set_Fill (CPI-C)

Articolo
07/21/2023

La chiamata Set_Fill ( cmsf nome funzione) specifica se i programmi riceveranno dati sotto forma di record logici o come lunghezza specificata di dati. Questa chiamata è consentita solo nelle conversazioni di base.

Sintassi

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

Riempire
Parametro fornito. Specifica il modulo in cui i programmi riceveranno i dati. Di seguito vengono indicate alcune tra le scelte possibili:

CM_FILL_BUFFER
Il programma locale riceve i dati fino al raggiungimento del numero di byte specificato dal parametro requested_length della chiamata Di ricezione o fino alla fine dei dati. I dati sono ricevuti senza considerare il formato di record logico.

CM_FILL_LL
I dati sono ricevuti in formato record logico. I dati ricevuti possono essere un record logico completo, una parte di un record logico uguale al parametro requested_length della chiamata Receive o la fine di un record logico.

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; si è verificato uno dei seguenti:

Il valore specificato da conversation_ID o riempimento non è valido.
Viene eseguito il mapping della conversazione corrente.

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ò trovarsi in qualsiasi stato, ad eccezione di RESET.

Non esiste alcuna modifica dello stato.

Commenti

Set_Fill esegue l'override del riempimento predefinito stabilito da Initialize_Conversation o Accept_Conversation. Il riempimento predefinito è CM_FILL_LL.

Il valore di riempimento influisce su tutte le chiamate di ricezione successive. Può essere modificato riemettendo la chiamata Set_Fill .

Condividi tramite