Set_Send_Type (CPI-C)

Der Set_Send_Type-Aufruf (Funktionsname cmsst) gibt an, wie Daten vom nächsten Send_Data-Aufruf gesendet werden. Er überschreibt den standardmäßigen Sendetyp, der von Initialize_Conversation oder Accept_Conversation festgelegt wurde. Der Standardsendetyp ist CM_BUFFER_DATA, was angibt, dass nur Daten (und keine Steuerungsinformationen) gesendet werden sollen.

Der send_type-Wert wirkt sich auf alle nachfolgenden Send_Data-Aufrufe aus. Sie kann durch erneutes Set_Send_Type geändert werden.

Syntax

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

send_type
Angegebener Parameter. Gibt an, wie Daten vom nächsten Send_Data-Aufruf gesendet werden. Mögliche Werte:

CM_BUFFER_DATA
Die Daten, auf die Send_Data verweisen, werden in einem Puffer gespeichert, bis der Puffer aufgefüllt oder geleert wird.

CM_SEND_AND_FLUSH
Die Daten, auf die Send_Data verweisen, sind sofort zu senden.

CM_SEND_AND_CONFIRM
Die Daten sind umgehend mit einer Bestätigungsanforderung zu senden.

CM_SEND_AND_PREP_TO_RECEIVE
Die Daten sind sofort zusammen mit der Benachrichtigung an das Partnerprogramm zu senden, dass sich der Unterhaltungszustand für das sendende Programm in RECEIVE ändert.

CM_SEND_AND_DEALLOCATE
Die Daten müssen sofort zusammen mit der Benachrichtigung über die Zuordnung gesendet werden.

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; eine der folgenden Ereignisse:

• Der durch conversation_ID oder send_type angegebene Wert ist ungültig.

• Der parameter send_type ist auf CM_SEND_AND_CONFIRM festgelegt, die Synchronisierungsebene für Unterhaltungen ist jedoch auf CM_NONE festgelegt.

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

  Zustandsänderungen

  Die Unterhaltung kann sich in einem beliebigen Zustand mit Ausnahme von RESET befinden.

  Es gibt keine Zustandsänderung.

Hinweise

Die send_type Werte, die dazu führen, dass zusätzliche Informationen mit den Daten gesendet werden, auf die von Send_Data können Sie die Anzahl der ausgegebenen Anrufe sparen. In der folgenden Tabelle sind Send_Data Äquivalenzen zusammengefasst.

Send_Data mit send_type , die auf diesen Wert festgelegt sind	Entspricht Send_Data, wobei send_type auf CM_BUFFER_DATA gefolgt von
CM_SEND_AND_FLUSH	Leerung
CM_SEND_AND_CONFIRM	Confirm
CM_SEND_AND_PREP_TO_RECEIVE	Prepare_To_Receive
CM_SEND_AND_DEALLOCATE	Zuordnung aufheben