Specify_Windows_Handle (CPI-C)

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

Sintaxis

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

Parámetros

hwndNotify
Parámetro proporcionado. Especifica el identificador Windows que se notificará cuando se complete la operación pendiente.

return_code
Código devuelto por 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 Windows no es válido.

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

Cambios de estado

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

Observaciones

Una aplicación puede establecer el modo de procesamiento llamando a Set_Processing_Mode. Si el identificador Windows está establecido 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.