Metodo IAccPropServices::ComposeHmenuIdentityString (oleacc.h)

I chiamanti usano ComposeHmenuIdentityString per recuperare una stringa di identità per un elemento accessibile basato su HMENU.

Sintassi

HRESULT ComposeHmenuIdentityString(
  [in]  HMENU hmenu,
  [in]  DWORD idChild,
  [out] BYTE  **ppIDString,
  [out] DWORD *pdwIDStringLen
);

Parametri

[in] hmenu

Tipo: HMENU

Identifica l'elemento accessibile basato su HMENU.

[in] idChild

Tipo: DWORD

Specifica l'ID figlio dell'elemento accessibile.

[out] ppIDString

Tipo: BYTE**

Puntatore a un buffer che riceve la stringa di identità. Il chiamante alloca questo buffer usando CoTaskMemAlloc. Al termine, il chiamante deve liberare il buffer chiamando CoTaskMemFree.

[out] pdwIDStringLen

Tipo: DWORD*

Puntatore a un buffer che riceve la lunghezza della stringa di identità.

Valore restituito

Tipo: HRESULT

Se ha esito positivo, restituisce S_OK.

Restituisce E_INVALIDARG se hmenu o idChild non è valido.

Può restituire altri codici di errore in condizioni di errore eccezionali, ad esempio bassa memoria.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione oleacc.h (include OleAcc.h Include Initguid.h first).
DLL Oleacc.dll
Componente ridistribuibile Accessibilità attiva 2.0 RDK in Windows NT 4.0 con SP6 e versioni successive e Windows 98