Método IAccessibleWindowlessSite::AcquireObjectIdRange (oleacc.h)
Adquiere un intervalo de identificadores de objeto del host de control y los marca como reservados por un control sin ventana específico.
Sintaxis
HRESULT AcquireObjectIdRange(
[in] long rangeSize,
[in, optional] IAccessibleHandler *pRangeOwner,
[out] long *pRangeBase
);
Parámetros
[in] rangeSize
Tamaño del intervalo de identificadores de objeto que se solicita.
[in, optional] pRangeOwner
Control sin ventana que solicita el intervalo.
[out] pRangeBase
El primer identificador de objeto del intervalo adquirido.
Valor devuelto
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Para evitar el uso de un identificador de objeto que pertenece a otro control sin ventanas, un control debe adquirir un intervalo de identificadores de objeto antes de llamar a la función NotifyWinEvent . Un control debe adquirir suficientes identificadores de objeto para todos sus objetos accesibles contenidos. Por ejemplo, un control de árbol con 100 elementos secundarios reservaría al menos 101 identificadores de objeto, uno para la raíz y otro para cada elemento secundario. Un control de árbol que se espera que crezca se reservaría tantos identificadores de objeto como se esperaba. Si se espera que el control de árbol crezca en varios cientos de niños, reservaría un intervalo de 1000 identificadores solo para ser seguros.
Cuando la ventana que contiene el control Microsoft ActiveX recibe un mensaje de WM_GETOBJECT con un valor LPARAM (id. de objeto) que se encuentra en un intervalo reservado, debe llamar al método IAccessibleHandler::AccessibleObjectFromID para obtener un objeto IAccessible para ese identificador de objeto.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2012 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | oleacc.h |
| Library | Oleacc.lib |
| Archivo DLL | Oleacc.dll |