Freigeben über

Test_Request_To_Send_Received (CPI-C)

  • Artikel

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              
);

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-Send-Empfangen-Indikator. Mögliche Werte:

CM_REQ_TO_SEND_RECEIVED
Das Partnerprogramm hat Request_To_Send ausgestellt, das das lokale Programm auffordert, die Unterhaltung in den EMPFANGSzustand zu ändern.

CM_REQ_TO_SEND_NOT_RECEIVED
Das Partnerprogramm hat keine Request_To_Send. 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 Produktfehlerprotokoll protokolliert.

Zustandsänderungen

Die Unterhaltung muss sich im Status SEND, RECEIVE oder SEND_PENDING befinden.

Es gibt keine Zustandsänderung.