Specify_Windows_Handle (CPI-C)

La llamada Specify_Windows_Handle (nombre de función xchwnd) establece el identificador de Microsoft® Windows® en el que se envía un mensaje al finalizar una operación en modo de bloqueo.

Sintaxis

  
CM_ENTRY Specify_Windows_Handle(   
  HWND hwndNotify,             
  CM_INT32 FAR *return_code    
);  

Parámetros

hwndNotify
Parámetro proporcionado. Especifica el identificador de Windows que se va a notificar cuando se completa la operación pendiente.

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_PARAMETER_CHECK
El identificador de Windows 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

El cambio de estado depende de la operación que se completó y su código de retorno.

Comentarios

Una aplicación puede establecer el modo de procesamiento llamando a Set_Processing_Mode. Si el identificador de Windows se establece en NULL o esta llamada nunca se emite, la aplicación debe llamar a Wait_For_Conversation para recibir una notificación cuando se complete la operación pendiente.

Cuando se completa una operación asincrónica, la ventana de aplicaciones hwndNotify recibe el mensaje devuelto por RegisterWindowMessage con "WinAsyncCPIC" como cadena de entrada. El valor wParam contiene el conversation_return_code de la operación que se está completando. Sus valores dependerán de la operación que se emitió originalmente. El argumento lParam contiene el CM_PTR al conversation_ID especificado en la llamada de función original.