Test_Request_To_Send_Received (CPI-C)

La chiamata Test_Request_To_Send_Received (nome funzione cmtrts) determina se è stata ricevuta una notifica da richiesta a invio dal programma partner.

Sintassi

  
CM_ENTRY Test_Request_To_Send_Received(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *request_to_send_received,    
  CM_INT32 FAR *return_code              
);  

Parametri

conversation_ID
Parametro fornito. Specifica l'identificatore per la conversazione. Il valore di questo parametro è stato restituito da Initialize_Conversation o Accept_Conversation.

request_to_send_received
Parametro restituito. Indicatore di tipo request-to-send-received. I valori possibili sono:

CM_REQ_TO_SEND_RECEIVED
Il programma partner ha rilasciato Request_To_Send, che richiede al programma locale di modificare lo stato della conversazione in RECEIVE.

CM_REQ_TO_SEND_NOT_RECEIVED
Il programma partner non ha eseguito Request_To_Send. Questo valore non è rilevante se return_code contiene un valore diverso da CM_OK.

return_code
Codice restituito da questa chiamata. I codici restituiti validi sono elencati più avanti in questo argomento.

Codici di ritorno

CM_OK
Codice restituito primario; la chiamata eseguita correttamente.

CM_PROGRAM_PARAMETER_CHECK
Codice restituito primario; il valore specificato da conversation_ID non è valido oppure l'indirizzo di una variabile non è valido.

CM_PROGRAM_STATE_CHECK
Codice restituito primario; la conversazione è in uno stato diverso da SEND, RECEIVE o SEND_PENDING.

CM_PRODUCT_SPECIFIC_ERROR
Codice restituito primario; si è verificato un errore specifico del prodotto ed è stato registrato nel log degli errori dei prodotti.

Modifiche dello stato

La conversazione deve essere in stato SEND, RECEIVE o SEND_PENDING.

Non viene apportata alcuna modifica allo stato.