Método ISearchBoxInfo::GetCondition (shobjidl.h)

  • Artigo

Recupera o conteúdo da caixa de pesquisa como um objeto ICondition .

Sintaxe

HRESULT GetCondition(
  [in]  REFIID riid,
  [out] void   **ppv
);

Parâmetros

[in] riid

Tipo: REFIID

Uma referência ao IID da interface a ser recuperada por meio de ppv, normalmente IID_ICondition.

[out] ppv

Tipo: void**

Quando esse método retorna com êxito, contém o ponteiro de interface solicitado em riid. Normalmente, isso é ICondition.

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

Ao contrário da cadeia de caracteres de texto recuperada por ISearchBoxInfo::GetText, GetCondition recupera as mesmas informações que um objeto estruturado, cujos métodos podem ser usados para analisar e manipular a cadeia de caracteres de pesquisa.

Recomendamos 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 no riid que pode levar a resultados inesperados.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl.h

Confira também

ISearchBoxInfo