Set_Prepare_To_Receive_Type (CPI-C)

La llamada Set_Prepare_To_Receive_Type (nombre de función cmsptr) especifica cómo se ejecutarán las llamadas Prepare_To_Receive posteriores. Invalida el procesamiento predeterminado de preparación para recibir establecido por Initialize_Conversation o Accept_Conversation. De forma predeterminada, el procesamiento de preparación para recibir se basa en el nivel de sincronización de la conversación.

El tipo de preparación para recibir afecta a todas las llamadas Prepare_To_Receive posteriores. Se puede cambiar al volver a emitir Set_Prepare_To_Receive_Type.

Sintaxis

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

prepare_to_receive_type
Parámetro proporcionado. Especifica cómo se ejecutarán las llamadas Prepare_To_Receive posteriores. Los valores posibles son:

CM_PREP_TO_RECEIVE_CONFIRM
Se usa para enviar al programa asociado el contenido del búfer de envío de la unidad lógica (LU) y una solicitud de confirmación. Tras recibir la confirmación, la conversación cambia al estado RECEIVE.

CM_PREP_TO_RECEIVE_FLUSH
Se usa para enviar al programa asociado el contenido del búfer de envío de LU local y cambia la conversación al estado RECEIVE.

CM_PREP_TO_RECEIVE_SYNC_LEVEL
Usado por el nivel de sincronización de conversaciones para determinar el procesamiento de preparación para recibir. Un nivel de sincronización predeterminado se establece mediante Initialize_Conversation y se puede invalidar mediante Set_Sync_Level.

Si el nivel de sincronización de la conversación es CM_NONE, el valor predeterminado es que el contenido del búfer de envío de LU local se envíe al programa asociado y la conversación cambie al estado RECEIVE. Si el nivel de sincronización de la conversación es CM_CONFIRM, el contenido de las LU locales envía el búfer y se envía una solicitud de confirmación al programa asociado. La conversación cambia al estado RECEIVE cuando el programa asociado emite Confirmado, respondiendo a la solicitud de confirmación.

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 prepare_to_receive_type o conversation_ID no es válido.

• El parámetro prepare_to_receive_type se establece en CM_PREP_TO_RECEIVE_CONFIRM, pero el nivel de sincronización de conversaciones se establece en CM_NONE.

  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.