Metodo IAccPropServices::D ecomposeHwndIdentityString (oleacc.h)

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

Sintassi

HRESULT DecomposeHwndIdentityString(
  [in]  const BYTE *pIDString,
  [in]  DWORD      dwIDStringLen,
  [out] HWND       *phwnd,
  [out] DWORD      *pidObject,
  [out] DWORD      *pidChild
);

Parametri

[in] pIDString

Tipo: const BYTE*

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

[in] dwIDStringLen

Tipo: DWORD

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

[out] phwnd

Tipo: HWND*

Puntatore a un buffer che riceve il valore HWND dell'elemento accessibile.

[out] pidObject

Tipo: DWORD*

Puntatore a un buffer che riceve l'ID di oggetto 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 phwnd, pidObject o pidChild non sono validi o se la stringa di identità specificata non è una stringa di identità basata su HWND.

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 HWND. Questo metodo è utile quando viene usato 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 cui il client chiama il server.

Requisiti