Método IAccPropServices::ComposeHwndIdentityString (oleacc.h)

Los autores de llamadas usan ComposeHwndIdentityString para recuperar una cadena de identidad.

Sintaxis

HRESULT ComposeHwndIdentityString(
  [in]  HWND  hwnd,
  [in]  DWORD idObject,
  [in]  DWORD idChild,
  [out] BYTE  **ppIDString,
  [out] DWORD *pdwIDStringLen
);

Parámetros

[in] hwnd

Tipo: HWND

Especifica el HWND del elemento accesible que el autor de la llamada quiere identificar.

[in] idObject

Tipo: DWORD

Especifica el id. de objeto del elemento accesible.

[in] idChild

Tipo: DWORD

Especifica el id. secundario del elemento accesible.

[out] ppIDString

Tipo: BYTE**

Puntero a un búfer que recibe la cadena de identidad. El destinatario asigna este búfer mediante CoTaskMemAlloc. Cuando termine, el autor de la llamada debe liberar el búfer llamando a CoTaskMemFree.

[out] pdwIDStringLen

Tipo: DWORD*

Puntero a un búfer que recibe la longitud de la cadena de identidad.

Valor devuelto

Tipo: HRESULT

Si se ejecuta correctamente, devuelve S_OK.

Devuelve E_INVALIDARG si hwnd, idObject o idChild no es válido.

Puede devolver otros códigos de error en condiciones de error excepcionales, como memoria baja.

Requisitos