IAccIdentity::GetIdentityString-Methode (oleacc.h)

  • Artikel

Ruft eine Bytezeichenfolge (eine Identitätszeichenfolge) ab, die ein barrierefreies Element eindeutig identifiziert.

Wenn Serverentwickler den HWND des Objekts kennen, das sie kommentieren möchten, können sie eine der folgenden Methoden verwenden, anstatt diese Methode zu verwenden und eine Identitätszeichenfolge zu erhalten.

Syntax

HRESULT GetIdentityString(
  [in]  DWORD dwIDChild,
  [out] BYTE  **ppIDString,
  [out] DWORD *pdwIDStringLen
);

Parameter

[in] dwIDChild

Typ: DWORD

Gibt an, welches untergeordnete Element des IAccessible-Objekts der Aufrufer identifizieren möchte.

[out] ppIDString

Typ: BYTE**

Die Adresse einer Variablen, die einen Zeiger auf eine vom Aufgerufenen reservierte Identitätszeichenfolge empfängt. Der Aufgerufene ordnet die Identitätszeichenfolge mithilfe von CoTaskMemAlloc zu. Der Aufrufer muss die Identitätszeichenfolge mithilfe von CoTaskMemFree freigeben, wenn er fertig ist.

[out] pdwIDStringLen

Typ: DWORD*

Die Adresse einer Variablen, die die Länge (in Bytes) der vom Aufgerufenen reservierten Identitätszeichenfolge empfängt.

Rückgabewert

Typ: HRESULT

Gibt S_OK zurück, außer bei außergewöhnlichen Fehlerbedingungen, z. B. bei geringem Arbeitsspeicher. Wenn dies nicht unterstützt wird, schlägt der Aufruf von QueryInterface auf IAccIdentity fehl.

Hinweise

Die zurückgegebene Zeichenfolge sollte als undurchsichtig angesehen werden. Clients sollten es nur als Ganzes verwenden und nicht versuchen, es zu trennen oder auf andere Weise manuell zu interpretieren.

Wenn ein Client weiß oder erwartet, dass eine Zeichenfolge HWND-basiert, kann er IAccPropServices::D ecomposeHwndIdentityString verwenden, um zu versuchen, die Identitätszeichenfolge zu zerlegen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista oder Windows XP
Unterstützte Mindestversion (Server) Windows Server 2003
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