Metode IAccessible::get_accChild (oleacc.h)

Artikel
08/25/2023

Metode IAccessible::get_accChild mengambil IDispatch untuk anak yang ditentukan, jika ada. Semua objek harus mendukung properti ini.

Sintaks

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

Parameter

[in] varChild

Jenis: VARIAN

Mengidentifikasi anak yang antarmuka IDispatch-nya diambil. Untuk informasi selengkapnya tentang menginisialisasi VARIAN, lihat Cara ID Anak Digunakan dalam Parameter.

[out, retval] ppdispChild

Jenis: IDispatch**

[out, retval] Menerima alamat antarmuka IDispatch objek anak.

Mengembalikan nilai

Jenis: HRESULT

Jika berhasil, mengembalikan S_OK.

Jika tidak berhasil, mengembalikan salah satu nilai dalam tabel berikut, atau kode kesalahan COM standar lainnya. Server mengembalikan nilai-nilai ini, tetapi klien harus selalu memeriksa parameter output untuk memastikan bahwa nilai tersebut berisi nilai yang valid. Untuk informasi selengkapnya, lihat Memeriksa Nilai Pengembalian IAccessible.

Kesalahan	Deskripsi
S_FALSE	Anak bukan objek yang dapat diakses.
E_INVALIDARG	Argumen tidak valid.

Keterangan

Server mengekspos elemen sebagai elemen (ID anak) atau objek penuh (penunjuk antarmuka IAccessible ). Jika anak adalah elemen, get_accChild mengembalikan S_FALSE, dan induk akan memberikan informasi untuk anak tersebut. Jika anak adalah objek penuh, get_accChild akan mengembalikan penunjuk antarmuka IAccessible dan induk tidak akan memberikan informasi tentang anak tersebut. Jika get_accChild gagal karena aplikasi server tidak dapat membuat objek yang dapat diakses karena kesalahan sistem sementara (seperti kesalahan kehabisan memori), server harus mengembalikan kode kegagalan yang sesuai.

Catatan untuk pengembang server: Jika varChildID berisi VT_EMPTY, Anda harus mengembalikan E_INVALIDARG.

Contoh Server

Contoh kode berikut menunjukkan implementasi untuk objek yang tidak memiliki anak, atau yang anak-anaknya adalah elemen daripada objek.


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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	oleacc.h
Pustaka	Oleacc.lib
DLL	Oleacc.dll
Redistribusi	Aksesibilitas Aktif 1.3 RDK pada Windows NT 4.0 dengan SP6 dan yang lebih baru dan Windows 95