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

Use SetPropValue para identificar el elemento accesible que se va a anotar, especificar la propiedad que se va a anotar y proporcionar un nuevo valor para esa propiedad.

Si los desarrolladores de servidores conocen el HWND del elemento accesible que quieren anotar, pueden usar uno de los métodos siguientes:

• IAccPropServices::SetHwndPropStr,
• IAccPropServices::SetHwndProp o
• IAccPropServices::SetHwndPropServer

Sintaxis

HRESULT SetPropValue(
  [in] const BYTE *pIDString,
  [in] DWORD      dwIDStringLen,
  [in] MSAAPROPID idProp,
  [in] VARIANT    var
);

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] idProp

Tipo: MSAAPROPID

Especifica la propiedad del elemento accesible que se va a anotar.

[in] var

Tipo: VARIANT

Especifica un nuevo valor para la propiedad.

Valor devuelto

Tipo: HRESULT

Si se ejecuta correctamente, devuelve S_OK.

Devuelve E_INVALIDARG si idProp no es una propiedad admitida, si var no es un tipo admitido para esa propiedad o si la cadena de identidad no es válida.

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. Tenga en cuenta que actualmente algunas propiedades solo se admiten cuando se usa una devolución de llamada y no se pueden especificar directamente mediante este método.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	oleacc.h (incluya OleAcc.h Include Initguid.h first).
Archivo DLL	Oleacc.dll
Redistribuible	RDK de accesibilidad activa 2.0 en Windows NT 4.0 con SP6 y versiones posteriores y Windows 98