Función CreateStdAccessibleProxyW (oleacc.h)

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

Sintaxis

HRESULT CreateStdAccessibleProxyW(
  [in]  HWND    hwnd,
  [in]  LPCWSTR 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 de

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 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 .

Observaciones

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 de IAccessible según sea necesario para que coincidan con sus controles personalizados. Como alternativa, los desarrolladores de servidores pueden usar la anotación dinámica para invalidar propiedades específicas sin tener que usar técnicas difíciles de subclases 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 de , 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 superclasado. 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 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 Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	oleacc.h
biblioteca de	Oleacc.lib
DLL de	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 interfaz de usuario admitidos

CreateStdAccessibleObject

IDispatch

accesos directos para exponer elementos de interfaz de usuario personalizados