Método IAccessible::get_accChild (oleacc.h)

Artículo
03/05/2024

El método IAccessible::get_accChild recupera un IDispatch para el elemento secundario especificado, si existe uno. Todos los objetos deben admitir esta propiedad.

Sintaxis

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

Parámetros

[in] varChild

Tipo: VARIANT

Identifica el elemento secundario cuya interfaz IDispatch se recupera. Para obtener más información sobre cómo inicializar variant, vea Cómo se usan los identificadores secundarios en parámetros.

[out, retval] ppdispChild

Tipo: IDispatch**

[out, retval] Recibe la dirección de la interfaz IDispatch del objeto secundario.

Valor devuelto

Tipo: HRESULT

Si se ejecuta correctamente, devuelve S_OK.

Si no se ejecuta correctamente, devuelve uno de los valores de la tabla siguiente u otro código de error COM estándar. Los servidores devuelven estos valores, pero los clientes siempre deben comprobar los parámetros de salida para asegurarse de que contienen valores válidos. Para obtener más información, vea Comprobación de valores devueltos de IAccessible.

Error	Descripción
S_FALSE	El elemento secundario no es un objeto accesible.
E_INVALIDARG	Un argumento no es válido.

Comentarios

Los servidores exponen elementos como elementos (identificadores secundarios) o objetos completos (punteros de interfaz IAccessible ). Si un elemento secundario es un elemento, get_accChild devuelve S_FALSE y el elemento primario proporcionará información para ese elemento secundario. Si el elemento secundario es un objeto completo, get_accChild devolverá el puntero de interfaz IAccessible y el elemento primario no proporcionará información sobre ese elemento secundario. Si get_accChild produce un error porque la aplicación de servidor no puede crear un objeto accesible debido a un error temporal del sistema (por ejemplo, un error de memoria insuficiente), el servidor debe devolver un código de error adecuado.

Nota para los desarrolladores de servidores: Si varChildID contiene VT_EMPTY, debe devolver E_INVALIDARG.

Ejemplo de servidor

En el código de ejemplo siguiente se muestra una implementación para un objeto que no tiene elementos secundarios o cuyos elementos secundarios son elementos en lugar de objetos.


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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	oleacc.h
Library	Oleacc.lib
Archivo DLL	Oleacc.dll
Redistribuible	RDK de accesibilidad activa 1.3 en Windows NT 4.0 con SP6 y versiones posteriores y Windows 95