Specify_Windows_Handle(CPI-C)

Specify_Windows_Handle调用(函数名称 xchwnd)设置在非阻止模式下完成作时向其发送消息Microsoft® Windows® 句柄。

语法

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

参数

hwndNotify
提供的参数。 指定要在完成未完成作时通知的 Windows 句柄。

return_code
从此调用返回的代码。 本主题后面列出了有效的返回代码。

返回代码

CM_OK
主要返回代码;调用已成功执行。

CM_PROGRAM_PARAMETER_CHECK
Windows 句柄无效。

CM_PRODUCT_SPECIFIC_ERROR
主要返回代码;发生了特定于产品的错误,并且已记录在产品错误日志中。

状态更改

状态更改取决于已完成的作及其返回代码。

注解

应用程序可以通过调用 Set_Processing_Mode来设置处理模式。 如果 Windows 句柄设置为 NULL,或者从未发出此调用,则应用程序必须调用 Wait_For_Conversation 才能在未完成的作完成时收到通知。

异步作完成后,应用程序窗口 hwndNotify 接收 RegisterWindowMessage 以“WinAsyncCPIC”作为输入字符串返回的消息。 wParam 值包含正在完成的作中的conversation_return_code。 其值将取决于最初发布的作。 lParam 参数包含原始函数调用中指定的conversation_ID CM_PTR。