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.

• IAccPropServices::SetHwndPropStr
• IAccPropServices::SetHwndProp
• IAccPropServices::SetHwndPropServer

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