Metodo IAccPropServices::D ecomposeHmenuIdentityString (oleacc.h)

Utilizzare questo metodo per determinare L'HMENU, l'ID oggetto e l'ID figlio per l'elemento accessibile identificato dalla stringa di identità.

Sintassi

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

Parametri

[in] pIDString

Tipo: const BYTE*

Puntatore a un buffer contenente la stringa di identità di un elemento accessibile basato su HMENU.

[in] dwIDStringLen

Tipo: DWORD

Indica la lunghezza della stringa di identità specificata da pIDString.

[out] phmenu

Tipo: HMENU*

Puntatore a un buffer che riceve l'HMENU dell'elemento accessibile.

[out] pidChild

Tipo: DWORD*

Puntatore a un buffer che riceve l'ID figlio dell'elemento accessibile.

Valore restituito

Tipo: HRESULT

Se ha esito positivo, restituisce S_OK.

Restituisce E_INVALIDARG se phmenu o pidChild non sono validi o se la stringa di identità specificata non è una stringa di identità basata su HMENU.

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

Commenti

Questo metodo ha esito positivo solo se la stringa di identità specificata è una stringa di identità basata su HMENU. Questo metodo è utile in un server di callback IAccPropServer registrato con ambito ANNO_CONTAINER perché consente al server di determinare, dalla stringa di identità specificata, l'elemento figlio (idChild) per il quale il client chiama il server.

Requisiti