Compartilhar via

Método IAccPropServices::D ecomposeHwndIdentityString (oleacc.h)

  • Artigo

Use esse método para determinar o HWND, a ID do objeto e a ID filho do elemento acessível identificado pela cadeia de caracteres de identidade.

Sintaxe

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*

Ponteiro para um buffer que contém a cadeia de caracteres de identidade de um elemento acessível baseado em HWND.

[in] dwIDStringLen

Tipo: DWORD

Especifica o comprimento da cadeia de caracteres de identidade especificada por pIDString.

[out] phwnd

Tipo: HWND*

Ponteiro para um buffer que recebe o HWND do elemento acessível.

[out] pidObject

Tipo: DWORD*

Ponteiro para um buffer que recebe a ID do objeto do elemento acessível.

[out] pidChild

Tipo: DWORD*

Ponteiro para um buffer que recebe a ID do filho do elemento acessível.

Retornar valor

Tipo: HRESULT

Se for bem-sucedido, retornará S_OK.

Retorna E_INVALIDARG se phwnd, pidObject ou pidChild não forem válidos ou se a cadeia de caracteres de identidade fornecida não for uma cadeia de caracteres de identidade baseada em HWND.

Pode retornar outros códigos de erro em condições de erro excepcionais, como memória baixa.

Comentários

Esse método só terá êxito se a cadeia de caracteres de identidade fornecida for uma cadeia de caracteres de identidade baseada em HWND. Esse método é útil quando usado em um servidor de retorno de chamada IAccPropServer que foi registrado com ANNO_CONTAINER escopo porque permite que o servidor determine, na cadeia de caracteres de identidade fornecida, o elemento filho (idChild) para o qual o cliente está chamando o servidor.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
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