Compartilhar via


Método IRawElementProviderFragment::GetEmbeddedFragmentRoots (uiautomationcore.h)

Recupera uma matriz de fragmentos raiz que são inseridos na árvore do Microsoft Automação da Interface do Usuário com raiz no elemento atual.

Sintaxe

HRESULT GetEmbeddedFragmentRoots(
  [out, retval] SAFEARRAY **pRetVal
);

Parâmetros

[out, retval] pRetVal

Tipo: SAFEARRAY**

Recebe uma matriz de ponteiros para os fragmentos raiz ou NULL (consulte Comentários). Este parâmetro é passado não inicializado.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Esse método retornará uma matriz de fragmentos somente se o elemento atual estiver hospedando outra estrutura de automação. A maioria dos provedores retorna NULL.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho uiautomationcore.h (inclua UIAutomation.h)

Confira também

Práticas recomendadas para usar matrizes seguras

Conceitual

Irawelementproviderfragment

Referência