Función CreateStdAccessibleProxyA (oleacc.h)

Crea un objeto accesible que tiene las propiedades y métodos de la clase especificada del elemento de interfaz de usuario proporcionado por el sistema.

Sintaxis

HRESULT CreateStdAccessibleProxyA(
  [in]  HWND   hwnd,
  [in]  LPCSTR pClassName,
  [in]  LONG   idObject,
  [in]  REFIID riid,
  [out] void   **ppvObject
);

Parámetros

[in] hwnd

Tipo: HWND

Identificador de ventana del elemento de interfaz de usuario proporcionado por el sistema (un control) para el que se crea un objeto accesible.

[in] pClassName

Tipo: LPCTSTR

Puntero a una cadena terminada en null del nombre de clase de un elemento de interfaz de usuario proporcionado por el sistema para el que se crea un objeto accesible. El nombre de la clase de ventana es uno de los controles comunes (definidos en Comctl32.dll), controles predefinidos (definidos en User32.dll) o elementos de ventana.

[in] idObject

Tipo: LONG

Id. de objeto. Este valor suele ser OBJID_CLIENT, que es una de las constantes de identificador de objeto, pero puede ser otro identificador de objeto.

[in] riid

Tipo: REFIID

Identificador de referencia de la interfaz solicitada. Este valor es uno de los siguientes: IID_IAccessible, IID_IDispatch, IID_IEnumVARIANT o IID_IUnknown.

[out] ppvObject

Tipo: void**

Dirección de una variable de puntero que recibe la dirección de la interfaz especificada.

Valor devuelto

Tipo: STDAPI

Si se ejecuta correctamente, devuelve S_OK.

Si no se ejecuta correctamente, devuelve un código de error COM estándar.

Comentarios

Las aplicaciones de servidor llaman a esta función cuando contienen un control personalizado similar a un control proporcionado por el sistema. Las aplicaciones de servidor pueden llamar a CreateStdAccessibleProxy para invalidar los métodos y propiedades IAccessible según sea necesario para que coincidan con sus controles personalizados. Como alternativa, los desarrolladores de servidores pueden usar anotaciones dinámicas para invalidar propiedades específicas sin tener que usar técnicas de subclases difíciles necesarias con CreateStdAccessibleProxy. Los desarrolladores de servidores deben seguir usando CreateStdAccessibleProxy para los cambios estructurales, como ocultar un elemento secundario o crear un elemento secundario de marcador de posición. Este enfoque ahorra a los desarrolladores de servidores el trabajo de implementar completamente todas las propiedades y métodos de IAccessible .

Esta función es similar a CreateStdAccessibleObject, salvo que CreateStdAccessibleObject siempre usa el nombre de clase asociado al hwnd , mientras que CreateStdAccessibleProxy permite especificar el nombre de clase como parámetro.

Use CreateStdAccessibleProxy para crear un objeto accesible para un elemento de interfaz de usuario superclase. Cuando se superclase un elemento de interfaz de usuario, una aplicación crea un control personalizado con un nombre de clase de ventana diferente del control predefinido en el que se basa. Dado que el nombre de clase asociado al parámetro hwnd es el nombre de la clase de ventana de superclase, especifique el nombre de clase base (el nombre de clase del sistema en el que se basa el control superclase) en pszClassName.

Nota

El encabezado oleacc.h define CreateStdAccessibleProxy como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	oleacc.h
Library	Oleacc.lib
Archivo DLL	Oleacc.dll
Redistribuible	RDK de accesibilidad activa 1.3 en Windows NT 4.0 con SP6 y versiones posteriores y Windows 95

Consulte también

Apéndice A: Referencia de elementos de la interfaz de usuario admitida

CreateStdAccessibleObject

IDispatch

Accesos directos para exponer elementos de interfaz de usuario personalizados