Metodo IAccessibleHandler::AccessibleObjectFromID (oleacc.h)

Articolo
08/25/2023

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.

NotaIAccessibleHandler::AccessibleObjectFromID è deprecato e non deve essere usato.

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.

Errore	Descrizione
E_INVALIDARG	Un argomento non è valido.
E_NOINTERFACE	L'interfaccia richiesta non è supportata.

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

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

Condividi tramite