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

Artikel
02/29/2024

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

Syntax

HRESULT DecomposeHmenuIdentityString(
  [in]  const BYTE *pIDString,
  [in]  DWORD      dwIDStringLen,
  [out] HMENU      *phmenu,
  [out] DWORD      *pidChild
);

Parameter

[in] pIDString

Typ: const BYTE*

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

[in] dwIDStringLen

Typ: DWORD

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

[out] phmenu

Typ: HMENU*

Zeiger auf einen Puffer, der die HMENU 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 phmenu oder pidChild ungültig sind oder wenn die angegebene Identitätszeichenfolge keine HMENU-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 HMENU-basierte Identitätszeichenfolge ist. Diese Methode ist in einem IAccPropServer-Rückrufserver nützlich, der bei ANNO_CONTAINER Bereich registriert wurde, da der Server anhand der angegebenen Identitätszeichenfolge das untergeordnete Element (idChild) bestimmen kann, 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