Metodo IAccessibleHandler::AccessibleObjectFromID (oleacc.h)

Il metodo AccessibleObjectFromID recupera un puntatore di interfaccia IAccessible per l'interfaccia associata all'ID oggetto specificato. Oleacc.dll usa questo metodo per ottenere un puntatore all'interfaccia IAccessible per i proxy forniti da altro codice.

Sintassi

HRESULT AccessibleObjectFromID(
  [in]  long         hwnd,
  [in]  long         lObjectID,
  [out] LPACCESSIBLE *pIAccessible
);

Parametri

[in] hwnd

Tipo: long

Specifica l'handle di una finestra per cui deve essere recuperato un puntatore all'interfaccia IAccessible .

[in] lObjectID

Tipo: long

Specifica l'ID di oggetto. Questo valore è una delle costanti dell'identificatore di oggetto standard o un ID oggetto personalizzato.

[out] pIAccessible

Tipo: LPACCESSIBLE*

Specifica l'indirizzo di una variabile puntatore che riceve l'indirizzo dell'interfaccia IAccessible dell'oggetto.

Valore restituito

Tipo: HRESULT

Se ha esito positivo, restituisce S_OK.

Se l'operazione non riesce, restituisce uno dei codici di errore COM seguenti o un altro codice di errore STANDARD.

Commenti

Oleacc chiama questa funzione per ottenere un puntatore di interfaccia IAccessible per HWNDcon il nome di classe per cui è registrato questo gestore.

All'avvio, Oleacc cerca la chiave del Registro di sistema HKLM\SOFTWARE\Microsoft\Active Accessibility\Handlers ed enumera su ogni sottochiave (Oleacc prevede che la sottochiave sia un GUID). Oleacc legge il nome della classe associato da HKCR\CLSID{guid}\AccClassName, dove {guid} è il GUID trovato nella chiave HKLM\SOFTWARE\Microsoft\Active Accessibility\Handlers. Quando Oleacc trova una finestra con un nome di classe corrispondente al GUID, crea l'oggetto usando il GUID, recupera il puntatore all'interfaccia IAccessibleHandler e chiama AccessibleObjectFromID su di esso per ottenere il puntatore all'interfaccia IAccessible .

Come con altri metodi e funzioni IAccessible , i client potrebbero ricevere errori per i puntatori di interfaccia IAccessible a causa di un'azione dell'utente. Per altre informazioni, vedere Ricezione di errori per puntatori di interfaccia IAccessible.

Requisiti