Test_Request_To_Send_Received (CPI-C)

Der Test_Request_To_Send_Received Aufruf (Funktionsname cmtrts) bestimmt, ob eine Anforderungs-zu-Senden-Benachrichtigung vom Partnerprogramm empfangen wurde.

Syntax

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

Die Parameter

conversation_ID
Angegebener Parameter. Gibt den Bezeichner für die Unterhaltung an. Der Wert dieses Parameters wurde von Initialize_Conversation oder Accept_Conversation zurückgegeben.

request_to_send_received
Zurückgegebener Parameter. Der Anforderungs-zu-Senden-Empfangen-Indikator. Mögliche Werte:

CM_REQ_TO_SEND_RECEIVED
Das Partnerprogramm hat Request_To_Send ausgestellt, das das lokale Programm anfordert, die Unterhaltung in den STATUS EMPFANGEN zu ändern.

CM_REQ_TO_SEND_NOT_RECEIVED
Das Partnerprogramm hat Request_To_Send nicht behoben. Dieser Wert ist nicht relevant, wenn return_code einen anderen Wert als CM_OK enthält.

return_code
Der von diesem Aufruf zurückgegebene Code. Die gültigen Rückgabecodes werden weiter unten in diesem Thema aufgeführt.

Rückgabecodes

CM_OK
Primärer Rückgabecode; Der Aufruf wurde erfolgreich ausgeführt.

CM_PROGRAM_PARAMETER_CHECK
Primärer Rückgabecode; Der durch conversation_ID angegebene Wert ist ungültig, oder die Adresse einer Variablen ist ungültig.

CM_PROGRAM_STATE_CHECK
Primärer Rückgabecode; die Unterhaltung befindet sich in einem anderen Zustand als SEND, RECEIVE oder SEND_PENDING.

CM_PRODUCT_SPECIFIC_ERROR
Primärer Rückgabecode; Ein produktspezifischer Fehler ist aufgetreten und wurde im Fehlerprotokoll der Produkte protokolliert.

Statusänderungen

Die Unterhaltung muss sich im Status "SENDEN", "EMPFANGEN" oder "SEND_PENDING" befinden.

Es gibt keine Zustandsänderung.