Compartir a través de

Test_Request_To_Send_Received (CPI-C)

  • Artículo

La llamada Test_Request_To_Send_Received ( cmtrts de nombre de función) determina si se ha recibido una notificación de solicitud a envío del programa asociado.

Sintaxis

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

request_to_send_received
Parámetro devuelto. Indicador de solicitud a envío recibido. Los valores posibles son:

CM_REQ_TO_SEND_RECEIVED
El programa asociado emitió Request_To_Send, que solicita al programa local que cambie la conversación al estado RECEIVE.

CM_REQ_TO_SEND_NOT_RECEIVED
El programa asociado no emitió Request_To_Send. Este valor no es relevante si return_code contiene un valor distinto de CM_OK.

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 no es válido o la dirección de una variable no es válida.

CM_PROGRAM_STATE_CHECK
Código de retorno principal; la conversación está en un estado distinto de SEND, RECEIVE o SEND_PENDING.

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, RECEIVE o SEND_PENDING.

No hay ningún cambio de estado.