Método IAccIdentity::GetIdentityString (oleacc.h)
Recupera una cadena de bytes (una cadena de identidad) que identifica de forma única un elemento accesible.
Si los desarrolladores de servidores conocen el HWND del objeto que quieren anotar, pueden usar uno de los métodos siguientes en lugar de usar este método y obtener una cadena de identidad.
Sintaxis
HRESULT GetIdentityString(
[in] DWORD dwIDChild,
[out] BYTE **ppIDString,
[out] DWORD *pdwIDStringLen
);
Parámetros
[in] dwIDChild
Tipo: DWORD
Especifica qué elemento secundario del objeto IAccessible que el autor de la llamada quiere identificar.
[out] ppIDString
Tipo: BYTE**
Dirección de una variable que recibe un puntero a una cadena de identidad asignada por el destinatario. El destinatario asigna la cadena de identidad mediante CoTaskMemAlloc; el autor de la llamada debe liberar la cadena de identidad mediante CoTaskMemFree cuando termine.
[out] pdwIDStringLen
Tipo: DWORD*
Dirección de una variable que recibe la longitud, en bytes, de la cadena de identidad asignada por el destinatario.
Valor devuelto
Tipo: HRESULT
Devuelve S_OK, excepto en condiciones de error excepcionales, como poca memoria. Si no se admite, se debe producir un error al llamar a QueryInterface en IAccIdentity .
Comentarios
La cadena devuelta debe considerarse opaca; los clientes deben usarlo solo como un todo y no intentar diseccionarlo ni interpretarlo manualmente.
Si un cliente conoce o espera que una cadena sea HWND, puede usar IAccPropServices::D ecomposeHwndIdentityString para intentar descomponer la cadena de identidad.
Requisitos
| Cliente mínimo compatible | Windows Vista o Windows XP |
| Servidor mínimo compatible | Windows Server 2003 |
| 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 |