IAccPropServices::ComposeHmenuIdentityString-Methode (oleacc.h)

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