Método IUIAutomationElement::GetCurrentPatternAs (uiautomationclient.h)

Artigo
03/03/2024

Recupera a interface de padrão de controle do padrão especificado neste elemento Automação da Interface do Usuário.

Sintaxe

HRESULT GetCurrentPatternAs(
  [in]  PATTERNID patternId,
  [in]  REFIID    riid,
  [out] void      **patternObject
);

Parâmetros

[in] patternId

Tipo: PATTERNID

O identificador do padrão de controle. Para obter uma lista de IDs de padrão de controle, consulte Identificadores de padrão de controle.

[in] riid

Tipo: REFIID

Uma referência à IID da interface a ser recuperada por meio de ppv.

[out] patternObject

Tipo: void**

Recebe o ponteiro de interface solicitado em riid.

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

É recomendável que você use a macro IID_PPV_ARGS , definida em Objbase.h, para empacotar os parâmetros riid e ppv . Essa macro fornece o IID correto com base na interface apontada pelo valor em ppv, o que elimina a possibilidade de um erro de codificação.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista, Windows XP com SP3 e Atualização de Plataforma para Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008, Windows Server 2003 com SP2 e Atualização de Plataforma para Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	uiautomationclient.h (inclua UIAutomation.h)