Método IAccIdentity::GetIdentityString (oleacc.h)
Recupera uma cadeia de caracteres de bytes (uma cadeia de caracteres de identidade) que identifica exclusivamente um elemento acessível.
Se os desenvolvedores de servidores souberem o HWND do objeto que desejam anotar, eles poderão usar um dos métodos a seguir em vez de usar esse método e obter uma cadeia de caracteres de identidade.
Sintaxe
HRESULT GetIdentityString(
[in] DWORD dwIDChild,
[out] BYTE **ppIDString,
[out] DWORD *pdwIDStringLen
);
Parâmetros
[in] dwIDChild
Tipo: DWORD
Especifica qual filho do objeto IAccessible o chamador deseja identificar.
[out] ppIDString
Tipo: BYTE**
Endereço de uma variável que recebe um ponteiro para uma cadeia de caracteres de identidade alocada pelo computador chamado. O receptor aloca a cadeia de caracteres de identidade usando CoTaskMemAlloc; o chamador deve liberar a cadeia de caracteres de identidade usando CoTaskMemFree quando terminar.
[out] pdwIDStringLen
Tipo: DWORD*
Endereço de uma variável que recebe o comprimento, em bytes, da cadeia de caracteres de identidade alocada pelo computador chamado.
Valor retornado
Tipo: HRESULT
Retornar S_OK, exceto em condições de erro excepcionais, como memória baixa. Se não houver suporte, a chamada de QueryInterface em IAccIdentity deverá falhar.
Comentários
A cadeia de caracteres retornada deve ser considerada opaca; os clientes devem usá-lo apenas como um todo e não devem tentar dissecá-lo ou interpretá-lo manualmente.
Se um cliente souber ou esperar que uma cadeia de caracteres seja baseada em HWND, ele poderá usar IAccPropServices::D ecomposeHwndIdentityString para tentar decompor a cadeia de caracteres de identidade.
Requisitos
| Cliente mínimo com suporte | Windows Vista ou Windows XP |
| Servidor mínimo com suporte | Windows Server 2003 |
| Plataforma de Destino | Windows |
| Cabeçalho | oleacc.h (inclua OleAcc.h Incluir Initguid.h primeiro.) |
| DLL | Oleacc.dll |
| Redistribuível | Active Accessibility 2.0 RDK no Windows NT 4.0 com SP6 e posterior e Windows 98 |