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