Compartir a través de

Set_Receive_Type (CPI-C)

  • Artículo

La llamada Set_Receive_Type (nombre de función cmsrt) especifica cómo el programa recibirá datos en las llamadas de recepción posteriores. Reemplaza el tipo de recepción predeterminado establecido por el Initialize_Conversation o Accept_Conversation llamada. De forma predeterminada, el programa espera a que lleguen los datos si no está disponible cuando se emite la llamada de recepción .

El valor del tipo de recepción afecta a todas las llamadas De recepción posteriores. Se puede cambiar reeditando Set_Receive_Type.

Sintaxis

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

receive_type
Parámetro proporcionado. Especifica cómo el programa recibe los datos en las llamadas de recepción posteriores. Los valores posibles son:

CM_RECEIVE_AND_WAIT
El programa local recibe los datos disponibles actualmente del programa asociado. Si no hay datos disponibles, el programa local espera a que lleguen los datos.

CM_RECEIVE_IMMEDIATE
El programa local recibe los datos disponibles actualmente del programa asociado. Si no hay datos disponibles, el programa local no espera.

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; el valor especificado por conversation_ID o receive_type no es válido o la dirección de una variable no es válida.

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.