Metodo IAccessible::get_accChild (oleacc.h)

Articolo
03/05/2024

Il metodo IAccessible::get_accChild recupera un IDispatch per l'elemento figlio specificato, se presente. Tutti gli oggetti devono supportare questa proprietà.

Sintassi

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

Parametri

[in] varChild

Tipo: VARIANT

Identifica l'elemento figlio di cui viene recuperata l'interfaccia IDispatch . Per altre informazioni sull'inizializzazione di VARIANT, vedere Modalità di utilizzo degli ID figlio nei parametri.

[out, retval] ppdispChild

Tipo: IDispatch**

[out, retval] Riceve l'indirizzo dell'interfaccia IDispatch dell'oggetto figlio.

Valore restituito

Tipo: HRESULT

Se ha esito positivo, restituisce S_OK.

In caso contrario, restituisce uno dei valori della tabella che segue o un altro codice di errore COM standard. I server restituiscono questi valori, ma i client devono sempre controllare i parametri di output per assicurarsi che contengano valori validi. Per altre informazioni, vedere Controllo dei valori restituiti IAccessible.

Errore	Descrizione
S_FALSE	L'elemento figlio non è un oggetto accessibile.
E_INVALIDARG	Un argomento non è valido.

Commenti

I server espongono gli elementi come elementi (ID figlio) o oggetti completi (puntatori di interfaccia IAccessible ). Se un elemento figlio è un elemento, get_accChild restituisce S_FALSE e l'elemento padre fornirà informazioni per tale elemento figlio. Se l'elemento figlio è un oggetto completo, get_accChild restituirà il puntatore all'interfaccia IAccessible e l'elemento padre non fornirà informazioni su tale elemento figlio. Se get_accChild ha esito negativo perché l'applicazione server non riesce a creare un oggetto accessibile a causa di un errore di sistema temporaneo,ad esempio un errore di memoria insufficiente, il server deve restituire un codice di errore appropriato.

Nota per gli sviluppatori di server: Se varChildID contiene VT_EMPTY, è necessario restituire E_INVALIDARG.

Esempio di server

Il codice di esempio seguente mostra un'implementazione per un oggetto che non ha elementi figlio o i cui elementi figlio sono elementi anziché oggetti .


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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	oleacc.h
Libreria	Oleacc.lib
DLL	Oleacc.dll
Componente ridistribuibile	Accessibilità attiva 1.3 RDK in Windows NT 4.0 con SP6 e versioni successive e Windows 95