IAccPropServices::D ecomposeHwndIdentityString-Methode (oleacc.h)

Artikel
02/29/2024

Verwenden Sie diese Methode, um die HWND, die Objekt-ID und die untergeordnete ID für das durch die Identitätszeichenfolge identifizierte barrierefreie Element zu ermitteln.

Syntax

HRESULT DecomposeHwndIdentityString(
  [in]  const BYTE *pIDString,
  [in]  DWORD      dwIDStringLen,
  [out] HWND       *phwnd,
  [out] DWORD      *pidObject,
  [out] DWORD      *pidChild
);

Parameter

[in] pIDString

Typ: const BYTE*

Zeiger auf einen Puffer, der die Identitätszeichenfolge eines HWND-basierten barrierefreien Elements enthält.

[in] dwIDStringLen

Typ: DWORD

Gibt die Länge der von pIDString angegebenen Identitätszeichenfolge an

[out] phwnd

Typ: HWND*

Zeiger auf einen Puffer, der den HWND des barrierefreien Elements empfängt.

[out] pidObject

Typ: DWORD*

Ein Zeiger auf einen Puffer, der die Objekt-ID des barrierefreien Elements empfängt.

[out] pidChild

Typ: DWORD*

Ein Zeiger auf einen Puffer, der die untergeordnete ID des barrierefreien Elements empfängt.

Rückgabewert

Typ: HRESULT

Gibt bei Erfolg S_OK zurück.

Gibt E_INVALIDARG zurück, wenn phwnd, pidObject oder pidChild ungültig sind oder wenn die angegebene Identitätszeichenfolge keine HWND-basierte Identitätszeichenfolge ist.

Kann andere Fehlercodes unter außergewöhnlichen Fehlerbedingungen wie z. B. wenig Arbeitsspeicher zurückgeben.

Hinweise

Diese Methode ist nur erfolgreich, wenn die bereitgestellte Identitätszeichenfolge eine HWND-basierte Identitätszeichenfolge ist. Diese Methode ist nützlich, wenn sie in einem IAccPropServer-Rückrufserver verwendet wird, der bei ANNO_CONTAINER Bereich registriert wurde, da sie es dem Server ermöglicht, aus der angegebenen Identitätszeichenfolge das untergeordnete Element (idChild) zu bestimmen, für das der Client den Server aufruft.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	oleacc.h (Include OleAcc.h Include Initguid.h first.)
DLL	Oleacc.dll
Verteilbare Komponente	Active Accessibility 2.0 RDK unter Windows NT 4.0 mit SP6 und höher und Windows 98

Freigeben über