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 會以 「WinAsyncCPIC」 作為輸入字串接收 RegisterWindowMessage 所傳回的訊息。 wParam值包含正在完成之作業的conversation_return_code。 其值將取決於最初發出的作業。 lParam引數包含原始函式呼叫中指定的conversation_ID CM_PTR。