IAccPropServices::SetHwndPropServer method (oleacc.h)

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

Syntax

HRESULT SetHwndPropServer(
  [in] HWND             hwnd,
  [in] DWORD            idObject,
  [in] DWORD            idChild,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps,
  [in] IAccPropServer   *pServer,
  [in] AnnoScope        annoScope
);

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

Type: const MSAAPROPID*

Specifies an array of properties that is to be handled by the specified callback object.

[in] cProps

Type: int

Specifies the number of properties in the paProps array.

[in] pServer

Type: IAccPropServer*

Specifies the callback object, which will be invoked when a client requests one of the overridden properties.

[in] annoScope

Type: AnnoScope

May be ANNO_THIS, indicating that the annotation affects the indicated accessible element only; or ANNO_CONTAINER, indicating that it applies to the element and its immediate element children.

Return value

Type: HRESULT

If successful, returns S_OK.

Returns E_INVALIDARG if any of the properties in the paProps array are not supported properties, if the identity string is not valid, or if annoScope is not one of ANNO_THIS or ANNO_CONTAINER.

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

SetHwndPropStr

SetPropServer