IAccPropServices::SetHwndPropStr method (oleacc.h)

This method wraps SetPropValue, providing a more convenient entry point for callers who are annotating HWND-based accessible elements.

Syntax

HRESULT SetHwndPropStr(
  [in] HWND       hwnd,
  [in] DWORD      idObject,
  [in] DWORD      idChild,
  [in] MSAAPROPID idProp,
  [in] LPCWSTR    str
);

Parameters

[in] hwnd

Type: HWND

Identifies the accessible element that is to be annotated. This replaces the identity string.

[in] idObject

Type: DWORD

Identifies the accessible element that is to be annotated. This replaces the identity string.

[in] idChild

Type: DWORD

Identifies the accessible element that is to be annotated. This replaces the identity string.

[in] idProp

Type: MSAAPROPID

Specifies which property of that element is to be annotated.

[in] str

Type: LPCWSTR

Specifies a new value for that property.

Return value

Type: HRESULT

If successful, returns S_OK.

May return other error codes under exceptional error conditions such as low memory.

Remarks

By using this method, the caller does not have to obtain an identity string; it can specify the hwnd, idObject, and idChild parameters directly.

Requirements

See also

ClearHwndProps

IAccPropServices

SetHwndProp

SetHwndPropServer

SetPropValue