Set_Fill (CPI-C)

Artículo
07/21/2023

La llamada Set_Fill (nombre de función cmsf) especifica si los programas recibirán datos en forma de registros lógicos o como una longitud especificada de datos. Esta llamada solo se permite en conversaciones básicas.

Sintaxis

  
CM_ENTRY Set_Fill(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *fill,                    
  CM_INT32 FAR *return_code              
);

Parámetros

conversation_ID
Parámetro proporcionado. Especifica el identificador de la conversación. El valor de este parámetro lo devolvió Initialize_Conversation o Accept_Conversation.

fill
Parámetro proporcionado. Especifica el formulario en el que los programas recibirán datos. Las siguientes son algunas posibles opciones:

CM_FILL_BUFFER
El programa local recibe datos hasta que se alcanza el número de bytes especificados por el parámetro requested_length de la llamada Receive o hasta el final de los datos. Los datos se reciben sin tener en cuenta el formato de registro lógico.

CM_FILL_LL
Los datos se reciben en formato de registro lógico. Los datos recibidos pueden ser un registro lógico completo, una parte de un registro lógico igual al parámetro requested_length de la llamada Receive o al final de un registro lógico.

return_code
Código devuelto de esta llamada. Los códigos de retorno válidos se enumeran más adelante en este tema.

Códigos de retorno

CM_OK
Código de retorno principal; la llamada se ejecutó correctamente.

CM_PROGRAM_PARAMETER_CHECK
Código de retorno principal; se produjo una de las siguientes acciones:

El valor especificado por conversation_ID o relleno no es válido.
La conversación actual está asignada.

CM_PRODUCT_SPECIFIC_ERROR
Código de retorno principal; se produjo un error específico del producto y se ha registrado en el registro de errores de productos.

Cambios de estado

La conversación puede estar en cualquier estado excepto RESET.

No hay ningún cambio de estado.

Comentarios

Set_Fill invalida el relleno predeterminado establecido por Initialize_Conversation o Accept_Conversation. El relleno predeterminado es CM_FILL_LL.

El valor de relleno afecta a todas las llamadas De recepción posteriores. Se puede cambiar reeditando la llamada Set_Fill .

Share via