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 ricezione della richiesta da inviare. 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 di ricezione della conversazione.

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 restituiti

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 si trova 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 di stato

La conversazione deve trovarsi nello stato SEND, RECEIVE o SEND_PENDING.

Non esiste alcuna modifica dello stato.