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