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。