Set_Processing_Mode (CPI-C)

  • Artículo

La llamada Set_Processing_Mode (nombre de función cmspm) especifica para la conversación si se devolverán llamadas posteriores cuando se complete la operación solicitada (bloqueo) o inmediatamente después de que se inicie la operación (sin bloqueo).

Nota

Se notifica a un programa la finalización de llamadas sin bloqueo cuando emite Wait_For_Conversation o a través de un mensaje de Microsoft® Windows® enviado a un WndProc identificado por el hWnd en la llamada Specify_Windows_Handle .

Sintaxis

  
CM_ENTRY Set_Processing_Mode(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *receive_type,            
  CM_INT32 FAR *return_code              
);

Parámetros

conversation_ID
Parámetro proporcionado. Especifica el identificador de la conversación. El valor de este parámetro lo devolvió Initialize_Conversation o Accept_Conversation.

receive_type
Parámetro proporcionado. Especifica si las llamadas posteriores en la conversación bloquearán o no se bloquearán. Los valores posibles son:

CM_BLOCKING
Las llamadas posteriores solo se devolverán cuando se complete la operación.

CM_NON_BLOCKING
Las llamadas posteriores se devolverán inmediatamente después de que se haya iniciado la operación.

return_code
Código devuelto de esta llamada. Los códigos de retorno válidos se enumeran más adelante en este tema.

Códigos de retorno

CM_OK
Código de retorno principal; la llamada se ejecutó correctamente.

CM_PROGRAM_STATE_CHECK
Código de retorno principal; la operación incompleta anterior en la conversación aún no se ha completado.

CM_PROGRAM_PARAMETER_CHECK
Código de retorno principal; el valor especificado por conversation_ID o processing_mode no es válido.

CM_PRODUCT_SPECIFIC_ERROR
Código de retorno principal; se produjo un error específico del producto y se ha registrado en el registro de errores de productos.

Cambios de estado

La conversación puede estar en cualquier estado excepto RESET.

No hay ningún cambio de estado.