Freigeben über

IAccPropServices::ComposeHmenuIdentityString-Methode (oleacc.h)

  • Artikel

Aufrufer verwenden ComposeHmenuIdentityString , um eine Identitätszeichenfolge für ein HMENU-basiertes barrierefreies Element abzurufen.

Syntax

HRESULT ComposeHmenuIdentityString(
  [in]  HMENU hmenu,
  [in]  DWORD idChild,
  [out] BYTE  **ppIDString,
  [out] DWORD *pdwIDStringLen
);

Parameter

[in] hmenu

Typ: HMENU

Identifiziert das HMENU-basierte barrierefreie Element.

[in] idChild

Typ: DWORD

Gibt die untergeordnete ID des barrierefreien Elements an.

[out] ppIDString

Typ: BYTE**

Ein Zeiger auf einen Puffer, der die Identitätszeichenfolge empfängt. Der Aufgerufene ordnet diesen Puffer mithilfe von CoTaskMemAlloc zu. Nach Abschluss des Vorgangs muss der Aufrufer den Puffer durch Aufrufen von CoTaskMemFree freigeben.

[out] pdwIDStringLen

Typ: DWORD*

Ein Zeiger auf einen Puffer, der die Länge der Identitätszeichenfolge empfängt.

Rückgabewert

Typ: HRESULT

Gibt bei Erfolg S_OK zurück.

Gibt E_INVALIDARG zurück, wenn hmenu oder idChild ungültig ist.

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

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 (OleAcc.h Include Initguid.h zuerst einschließen.)
DLL Oleacc.dll
Verteilbare Komponente Active Accessibility 2.0 RDK unter Windows NT 4.0 mit SP6 und höher und Windows 98