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

Consulte también

IAccessibleWindowlessSite

IAccessibleWindowlessSite::ReleaseObjectIdRange