Método IAccPropServices::D ecomposeHwndIdentityString (oleacc.h)

Use este método para determinar el HWND, el identificador de objeto y el identificador secundario del elemento accesible identificado por la cadena de identidad.

Sintaxis

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

Parámetros

[in] pIDString

Tipo: const BYTE*

Puntero a un búfer que contiene una cadena de identidad de un elemento accesible basado en HWND.

[in] dwIDStringLen

Tipo: DWORD

Especifica la longitud de la cadena de identidad especificada por pIDString.

[out] phwnd

Tipo: HWND*

Puntero a un búfer que recibe el HWND del elemento accesible.

[out] pidObject

Tipo: DWORD*

Puntero a un búfer que recibe el id. de objeto del elemento accesible.

[out] pidChild

Tipo: DWORD*

Puntero a un búfer que recibe el id. secundario del elemento accesible.

Valor devuelto

Tipo: HRESULT

Si se ejecuta correctamente, devuelve S_OK.

Devuelve E_INVALIDARG si phwnd, pidObject o pidChild no son válidos, o si la cadena de identidad especificada no es una cadena de identidad basada en HWND.

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

Comentarios

Este método solo se realiza correctamente si la cadena de identidad proporcionada es una cadena de identidad basada en HWND. Este método es útil cuando se usa en un servidor de devolución de llamada IAccPropServer que se registró con ANNO_CONTAINER ámbito porque permite al servidor determinar, desde la cadena de identidad especificada, el elemento secundario (idChild) para el que el cliente llama al servidor.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado oleacc.h (incluya OleAcc.h Include Initguid.h first).)
Archivo DLL Oleacc.dll
Redistribuible RDK de accesibilidad activa 2.0 en Windows NT 4.0 con SP6 y versiones posteriores y Windows 98