Set_Processing_Mode (CPI-C)

Der Set_Processing_Mode Aufruf (Funktionsname cmspm) gibt für die Unterhaltung an, ob nachfolgende Aufrufe zurückgegeben werden, wenn der angeforderte Vorgang abgeschlossen ist (Blockieren) oder unmittelbar nach dem Initiieren des Vorgangs (Nichtblockierung).

Hinweis

Ein Programm wird über den Abschluss von Nichtblockierungsaufrufen benachrichtigt, wenn es Wait_For_Conversation oder über eine Microsoft® Windows-Nachricht® sendet, die an einen WndProc gesendet wird, 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              
);  

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.

receive_type
Angegebener Parameter. Gibt an, ob nachfolgende Aufrufe für die 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 unmittelbar nach dem Initiieren 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 wurde 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 Fehlerprotokoll der Produkte protokolliert.

Statusänderungen

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

Es gibt keine Zustandsänderung.