Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | oleacc.h (include OleAcc.h Include Initguid.h first.) |
| DLL | Oleacc.dll |
| Redistributable | Active Accessibility 2.0 RDK on Windows NT 4.0 with SP6 and later and Windows 98 |