Set_Processing_Mode (CPI-C)

Der Set_Processing_Mode-Aufrufs (Funktionsname cmspm) gibt für die Konversation an, ob nachfolgende Aufrufe zurückgegeben werden, wenn der angeforderte Vorgang abgeschlossen (blockiert) oder unmittelbar nach dem Initiieren des Vorgangs (Nonblocking) zurückgegeben wird.

Hinweis

Ein Programm wird über den Abschluss von Nichtblockierungsaufrufen benachrichtigt, wenn es Wait_For_Conversation oder über eine Microsoft® Windows-Nachricht® an einen WndProc sendet, der vom hWnd im Specify_Windows_Handle-Aufruf identifiziert wurde.

Syntax

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

receive_type
Angegebener Parameter. Gibt an, ob nachfolgende Aufrufe der Unterhaltung blockiert oder nicht blockiert werden. Mögliche Werte:

CM_BLOCKING
Nachfolgende Aufrufe werden nur zurückgegeben, wenn der Vorgang abgeschlossen ist.

CM_NON_BLOCKING
Nachfolgende Aufrufe werden sofort nach dem Starten des Vorgangs zurückgegeben.

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_STATE_CHECK
Primärer Rückgabecode; der vorherige unvollständige Vorgang für die Unterhaltung ist noch nicht abgeschlossen.

CM_PROGRAM_PARAMETER_CHECK
Primärer Rückgabecode; Der durch conversation_ID oder processing_mode angegebene Wert ist ungültig.

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.