Compartir a través de

Set_Conversation_Type (CPI-C)

  • Artículo

El programa de invocación emite la llamada Set_Conversation_Type ( cmsct) de nombre de función para definir una conversación como asignada o básica. Esta llamada invalida el tipo de conversación predeterminado establecido por Initialize_Conversation. El tipo de conversación predeterminado es CM_MAPPED_CONVERSATION. Esta llamada no se puede emitir después de que se haya emitido Allocate .

Sintaxis

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

conversation_type
Parámetro proporcionado. Especifica el tipo de conversación que asignará Allocate. Los valores posibles son:

  • CM_BASIC_CONVERSATION

  • CM_MAPPED_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_PROGRAM_STATE_CHECK
Código de retorno principal; la conversación no está en estado INITIALIZE.

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

  • El valor especificado por conversation_ID o conversation_type no es válido.

  • El parámetro conversation_type especifica una conversación asignada, pero la característica de relleno se establece en CM_FILL_BUFFER, que no es compatible con las conversaciones asignadas. Antes de cambiar el tipo de conversación a asignado, debe emitir la llamada Set_Fill para cambiar el tipo de relleno a CM_FILL_LL.

  • El parámetro conversation_type especifica una conversación asignada. Sin embargo, una llamada de Set_Log_Data anterior, permitida solo en conversaciones básicas, sigue en vigor.

    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 INITIALIZE.

No hay ningún cambio de estado.