次の方法で共有

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
プライマリ リターン コード。製品固有のエラーが発生し、製品エラー ログに記録されています。

State Changes (状態の変化)

状態の変更は、完了した操作とその戻りコードによって異なります。

注釈

アプリケーションは、Set_Processing_Modeを呼び出すことによって処理モード を設定できます。 Windows ハンドルが NULL に設定されているか、この呼び出しが発行されない場合、アプリケーションは未処理の操作が完了したときに通知を受け取るために Wait_For_Conversation を呼び出す必要があります。

非同期操作が完了すると、アプリケーション ウィンドウ hwndNotify は、 RegisterWindowMessage によって返されたメッセージを、入力文字列として "WinAsyncCPIC" と共に受け取ります。 wParam 値には、完了している操作のconversation_return_codeが含まれています。 その値は、最初に発行された操作によって異なります。 lParam 引数には、元の関数呼び出しで指定されたconversation_IDへのCM_PTRが含まれています。