Compartir a través de

Método IAccIdentity::GetIdentityString (oleacc.h)

  • Artículo

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