Método IAccPropServices::SetPropServer (oleacc.h)

Los servidores usan SetPropServer para especificar un objeto de devolución de llamada que se usará para anotar una matriz de propiedades para el elemento accesible. También puede especificar si la anotación se va a aplicar a este elemento accesible o al elemento y a sus elementos secundarios. Este método se usa para la anotación del servidor.

Si los desarrolladores de servidores conocen el HWND del elemento accesible que quieren anotar, pueden usar IAccPropServices::SetHwndPropServer.

Sintaxis

HRESULT SetPropServer(
  [in] const BYTE       *pIDString,
  [in] DWORD            dwIDStringLen,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps,
  [in] IAccPropServer   *pServer,
  [in] AnnoScope        annoScope
);

Parámetros

[in] pIDString

Tipo: const BYTE*

Identifica el elemento accesible que se va a anotar.

[in] dwIDStringLen

Tipo: DWORD

Especifica la longitud de la cadena identificada por el parámetro pIDString.

[in] paProps

Tipo: const MSAAPROPID*

Especifica una matriz de propiedades que va a controlar el objeto de devolución de llamada especificado.

[in] cProps

Tipo: int

Especifica una matriz de propiedades que va a controlar el objeto de devolución de llamada especificado.

[in] pServer

Tipo: IAccPropServer*

Especifica el objeto de devolución de llamada, que se invocará cuando un cliente solicite una de las propiedades reemplazadas.

[in] annoScope

Tipo: AnnoScope

Puede ser ANNO_THIS, que indica que la anotación afecta únicamente al elemento accesible indicado; o bien, puede ser ANNO_CONTAINER, que indica que se aplica al elemento y a su elemento secundario inmediato.

Valor devuelto

Tipo: HRESULT

Si se ejecuta correctamente, devuelve S_OK.

Devuelve E_INVALIDARG si alguna de las propiedades de la matriz paProps no es compatible, si la cadena de identidad no es válida o si annoScope no es una de ANNO_THIS o ANNO_CONTAINER.

Puede devolver otros códigos de error en condiciones de error excepcionales, como memoria baja.

Comentarios

Consulte la sección de soporte técnico para obtener una lista de las propiedades admitidas y sus tipos esperados.

El tiempo de ejecución de la anotación usará AddRef para incrementar el contador de referencia del objeto de devolución de llamada pServer correctamente. El autor de la llamada es libre de liberarlo después de llamar a este método. El tiempo de ejecución de la anotación liberará automáticamente el objeto de devolución de llamada después de que ya no se use el elemento accesible anotado.

Requisitos