Freigeben über


IAccPropServices::ComposeHwndIdentityString-Methode (oleacc.h)

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