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