IAccPropServices::ComposeHwndIdentityString-Methode (oleacc.h)

Artikel
08/25/2023

Aufrufer verwenden ComposeHwndIdentityString , um eine Identitätszeichenfolge abzurufen.

Syntax

HRESULT ComposeHwndIdentityString(
  [in]  HWND  hwnd,
  [in]  DWORD idObject,
  [in]  DWORD idChild,
  [out] BYTE  **ppIDString,
  [out] DWORD *pdwIDStringLen
);

Parameter

[in] hwnd

Typ: HWND

Gibt den HWND des barrierefreien Elements an, das der Aufrufer identifizieren möchte.

[in] idObject

Typ: DWORD

Gibt die Objekt-ID des barrierefreien Elements an.

[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 hwnd, idObject 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