Compartir a través de

Flush (CPI-C)

  • Artículo

La llamada Flush (nombre de función cmflus) envía el contenido del búfer de envío de la unidad lógica local (LU) al LU asociado (y programa). Si el búfer de envío está vacío, no se realiza ninguna acción.

Sintaxis

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

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_OPERATION_NOT_ACCEPTED
Código de retorno principal; Una operación anterior en esta conversación está incompleta.

CM_OPERATION_INCOMPLETE
Código de retorno principal; la operación no se ha completado (el modo de procesamiento es solo de bloqueo) y todavía está en curso. El programa puede emitir Wait_For_Conversation para esperar la finalización de la operación, o Cancel_Conversation para cancelar la operación y la conversación. Si se ha llamado a Specify_Windows_Handle , la aplicación debe esperar la notificación por un mensaje de Microsoft® Windows® y no llamar a Wait_For_Conversation.

CM_PROGRAM_PARAMETER_CHECK
Código de retorno principal; el valor especificado por conversation_ID no es válido.

CM_PROGRAM_STATE_CHECK
Código de retorno principal; la conversación no estaba en estado SEND o SEND_PENDING cuando el programa emitió esta llamada.

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 debe estar en estado SEND o SEND_PENDING.

Si la llamada se completa correctamente, (return_code es CM_OK ), la conversación se encuentra en estado SEND.

Otros códigos de retorno no producen ningún cambio de estado.

Comentarios

Los datos procesados por Send_Data se acumulan en el búfer de envío local hasta que se produzca una de las siguientes acciones:

  • El programa local emite la llamada Flush u otra llamada que vacía el búfer de envío de las LU. (Algunos tipos de envío, establecidos por Set_Send_Type, incluyen la funcionalidad de vaciado).

  • El búfer está lleno.

    La solicitud de asignación generada por La asignación y la información de error generada por Send_Error también se almacenan en búfer.