IAccessible::get_accChild メソッド (oleacc.h)

[アーティクル]
02/29/2024

IAccessible::get_accChild メソッドは、指定した子の IDispatch (存在する場合) を取得します。すべてのオブジェクトでこのプロパティがサポートされている必要があります。

構文

HRESULT get_accChild(
  [in]          VARIANT   varChild,
  [out, retval] IDispatch **ppdispChild
);

パラメーター

[in] varChild

型: VARIANT

IDispatch インターフェイスが取得される子を識別します。 VARIANT の初期化の詳細については、「子 ID をパラメーターで使用する方法」を参照してください。

[out, retval] ppdispChild

種類: IDispatch**

[out, retval]子オブジェクトの IDispatch インターフェイスのアドレスを受け取ります。

戻り値

種類: HRESULT

成功した場合は、S_OK を返します。

成功しなかった場合は、次のテーブルの値の 1 つ、または別の標準 COM エラーコードを返します。サーバーはこれらの値を返しますが、クライアントは常に出力パラメーターをチェックして、有効な値が含まれていることを確認する必要があります。詳細については、「 IAccessible 戻り値の確認」を参照してください。

エラー	説明
S_FALSE	子はアクセス可能なオブジェクトではありません。
E_INVALIDARG	引数が有効ではありません。

注釈

サーバーは、要素 (子 ID) または完全なオブジェクト (IAccessible インターフェイスポインター) として要素を公開します。子が要素の場合、 get_accChild はS_FALSEを返し、親はその子の情報を提供します。子が完全なオブジェクトである場合、 get_accChild は IAccessible インターフェイスポインターを返し、親はその子に関する情報を提供しません。 サーバー アプリケーションが一時的なシステムエラー (メモリ不足エラーなど) のためにアクセス可能なオブジェクトを作成できないためにget_accChildが失敗した場合、サーバーは適切なエラーコードを返す必要があります。

サーバー開発者への注意: varChildID にVT_EMPTYが含まれている場合は、E_INVALIDARGを返す必要があります。

サーバーの例

次のコード例は、子を持たないオブジェクト、または子がオブジェクトではなく要素であるオブジェクトの実装を示しています。


HRESULT STDMETHODCALLTYPE AccServer::get_accChild( 
    VARIANT varChild,
    IDispatch **ppdispChild)
{
    if (varChild.vt != VT_I4)
    {
        *ppdispChild = NULL;
        return E_INVALIDARG;
    }
    *ppdispChild = NULL;    
    return S_FALSE;     
};

要件

要件	値
サポートされている最小のクライアント	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