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 durch Initialize_Conversation oder Accept_Conversation eingerichtet wurde. Der Standardmäßige Sendetyp ist CM_BUFFER_DATA, der angibt, dass nur Daten (und keine Steuerelementinformationen) gesendet werden sollen.

Der send_type Wert wirkt sich auf alle nachfolgenden Send_Data Aufrufe aus. Sie kann geändert werden, indem sie Set_Send_Type erneut angibt.

Syntax

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

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

CM_BUFFER_DATA
Die daten, auf die von Send_Data verwiesen wird, werden in einem Puffer gespeichert, bis der Puffer gefüllt oder geleert wird.

CM_SEND_AND_FLUSH
Die von Send_Data verwiesenen Daten sind sofort zu senden.

CM_SEND_AND_CONFIRM
Die Daten sollen sofort mit einer Bestätigungsanforderung gesendet werden.

CM_SEND_AND_PREP_TO_RECEIVE
Die Daten werden sofort zusammen mit der Benachrichtigung an das Partnerprogramm gesendet, dass der Unterhaltungsstatus für das Sendeprogramm zu EMPFANGEN wechselt.

CM_SEND_AND_DEALLOCATE
Die Daten werden sofort zusammen mit der Deallocation-Benachrichtigung gesendet.

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

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

• Der parameter send_type wird auf CM_SEND_AND_CONFIRM festgelegt, die Synchronisierungsebene der Unterhaltungen wird jedoch auf CM_NONE festgelegt.

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

  Statusänderungen

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

  Es gibt keine Zustandsänderung.

Bemerkungen

Die send_type Werte, die dazu führen, dass zusätzliche Informationen mit den daten gesendet werden, auf die durch Send_Data verwiesen wird, ermöglichen es Ihnen, die Anzahl der ausgegebenen Anrufe zu sparen. In der folgenden Tabelle sind Send_Data Äquivalenz zusammengefasst.