WinRUI
WinRUI 関数は、すべての Microsoft® Windows® ベースの要求ユニット インターフェイス (RUI) 動詞に非同期メッセージ通知を提供します。
構文
int WINAPI WinRUI(
HWND hWnd,
LUA_VERB_RECORD FAR *lpVCB
);
パラメーター
hWnd
メッセージを受信するウィンドウのハンドル。
lpVCB
論理ユニット アプリケーション (LUA) 動詞制御ブロック (VCB)、 LUA_VERB_RECORDへのポインター。
戻り値
この関数は、処理のために Windows ベースの RUI によって要求が受け入れられたかどうかを示す値を返します。 戻り値が 0 の場合は、要求が受け入れられ、処理されることを示します。 0 以外の値はエラーを示します。 考えられるエラー コードは次のとおりです。
WLUAINVALIDHANDLE
指定されたウィンドウ ハンドルが無効です。
WLUASTARTUPNOTCALLED
アプリケーションが WinRUIStartup を使用してセッションを開始していません。
lua_flag2.async で返される値は、非同期通知が発生するかどうかを示します。 フラグが (0 以外) に設定されている場合、非同期通知は、アプリケーション メッセージ キューにポストされたメッセージを通じて発生します。 フラグが設定されていない場合、要求は同期的に完了しました。 エラー条件について、プライマリ リターン コードとセカンダリ リターン コードを調べます。
注釈
非同期操作が完了すると、アプリケーション ウィンドウ hWnd は、入力文字列として "WinRUI" を持つ RegisterWindowMessage によって返されるメッセージを受け取ります。 lParam 引数には、完全としてポストされる VCB のアドレスが含まれます。 wParam 引数は未定義です。
Note
要求は処理のために受け入れられる可能性がありますが (関数呼び出しは 0 を返します)、VCB でプライマリリターンコードとセカンダリリターンコードセットを使用して後で拒否されます。 エラー条件について、プライマリ リターン コードとセカンダリ リターン コードを調べます。
アプリケーションが WinRUIStartup を使用してセッションを初期化せずに WinRUI を呼び出すと、エラーが返されます。