LresultFromObject 関数 (oleacc.h)

  • [アーティクル]

ハンドルと同様に、指定したオブジェクトへの参照を返します。 サーバーは、WM_GETOBJECTを処理するときにこの参照 を返します。

構文

LRESULT LresultFromObject(
  [in] REFIID    riid,
  [in] WPARAM    wParam,
  [in] LPUNKNOWN punk
);

パラメーター

[in] riid

種類: REFIID

クライアントに提供されるインターフェイスの参照識別子。 このパラメーターはIID_IAccessible。

[in] wParam

種類: WPARAM

関連付けられた WM_GETOBJECT メッセージによって wParam パラメーターで送信される値。

[in] punk

種類: LPUNKNOWN

WM_GETOBJECT メッセージに対応する オブジェクトへの IAccessible インターフェイスのアドレス。

戻り値

型: LRESULT

成功した場合は、 オブジェクトへの参照である正の値を返します。

成功しなかった場合は、次のテーブルの値の 1 つ、または別の標準 COM エラー コードを返します。

リターン コード 説明
E_INVALIDARG
 1 つ以上の引数が無効です。
E_NOINTERFACE
 pAcc パラメーターで指定されたオブジェクトは、riid パラメーターで指定されたインターフェイスをサポートしていません。
E_OUTOFMEMORY
 オブジェクト参照を格納するためのメモリが不足しています。
E_UNEXPECTED
 予期しないエラーが発生しました。

注釈

サーバーは、WM_GETOBJECT メッセージを処理する場合にのみ、この関数 を 呼び出します。 LresultFromObject がWM_GETOBJECTに関連する方法の概要については、「How WM_GETOBJECT Works」を参照してください。

LresultFromObject は、 オブジェクトの参照カウントをインクリメントします。 関数に渡されたインターフェイス ポインターを格納していない場合 (つまり、 WM_GETOBJECT 受信するたびにオブジェクトの新しいインターフェイス ポインターを作成します)、オブジェクトの Release メソッドを呼び出して参照カウントを 1 に減らします。 その後、クライアントは Release を 呼び出し、オブジェクトは破棄されます。 詳細については、「 WM_GETOBJECTを処理する方法」を参照してください。

サーバーは、特定のオブジェクト のWM_GETOBJECT を処理するたびに LresultFromObject を呼び出して、オブジェクトへの新しい参照を取得します。 サーバーは、同じオブジェクトに対して後続のWM_GETOBJECTメッセージを処理するときにメッセージの戻り値として使用する処理WM_GETOBJECTの 1 つのインスタンスから LresultFromObject から返された参照を保存しません。 これにより、クライアントはエラーを受け取ります。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー oleacc.h
Library Oleacc.lib
[DLL] Oleacc.dll
再頒布可能パッケージ SP6 以降および Windows 95 を使用した Windows NT 4.0 の Active Accessibility 1.3 RDK

こちらもご覧ください

プロキシ オブジェクトの作成

WM_GETOBJECTのしくみ

WM_GETOBJECTを処理する方法

WM_GETOBJECT