IAccPropServices::D ecomposeHmenuIdentityString-Methode (oleacc.h)

Verwenden Sie diese Methode, um die HMENU, die Objekt-ID und die untergeordnete ID für das durch die Identitätszeichenfolge identifizierte barrierefreie Element zu ermitteln.

Syntax

HRESULT DecomposeHmenuIdentityString(
  [in]  const BYTE *pIDString,
  [in]  DWORD      dwIDStringLen,
  [out] HMENU      *phmenu,
  [out] DWORD      *pidChild
);

Parameter

[in] pIDString

Typ: const BYTE*

Zeiger auf einen Puffer, der die Identitätszeichenfolge eines HMENU-basierten barrierefreien Elements enthält.

[in] dwIDStringLen

Typ: DWORD

Gibt die Länge der von pIDString angegebenen Identitätszeichenfolge an

[out] phmenu

Typ: HMENU*

Zeiger auf einen Puffer, der die HMENU des barrierefreien Elements empfängt.

[out] pidChild

Typ: DWORD*

Ein Zeiger auf einen Puffer, der die untergeordnete ID des barrierefreien Elements empfängt.

Rückgabewert

Typ: HRESULT

Gibt bei Erfolg S_OK zurück.

Gibt E_INVALIDARG zurück, wenn phmenu oder pidChild ungültig sind oder wenn die angegebene Identitätszeichenfolge keine HMENU-basierte Identitätszeichenfolge ist.

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

Hinweise

Diese Methode ist nur erfolgreich, wenn die bereitgestellte Identitätszeichenfolge eine HMENU-basierte Identitätszeichenfolge ist. Diese Methode ist in einem IAccPropServer-Rückrufserver nützlich, der bei ANNO_CONTAINER Bereich registriert wurde, da der Server anhand der angegebenen Identitätszeichenfolge das untergeordnete Element (idChild) bestimmen kann, für das der Client den Server aufruft.

Anforderungen