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 |