Método IConditionFactory::MakeNot (structuredquery.h)

Artigo
03/02/2024

Cria um nó de condição que é uma negação lógica (NOT) de outra condição (um subnodo desse nó).

Sintaxe

HRESULT MakeNot(
  [in]          ICondition *pcSub,
  [in]          BOOL       fSimplify,
  [out, retval] ICondition **ppcResult
);

Parâmetros

[in] pcSub

Tipo: ICondition*

Ponteiro para o subnodo ICondition a ser negado.

[in] fSimplify

Tipo: BOOL

TRUE para simplificar logicamente o resultado, se possível; FALSE caso contrário. Em um cenário de construtor de consultas, o fSimplify normalmente deve ser definido como VARIANT_FALSE.

[out, retval] ppcResult

Tipo: ICondition**

Recebe um ponteiro para o novo nó 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

A simplificação lógica de um nó de condição geralmente resulta em uma árvore de condição menor, mais facilmente percorrida e processada. Por exemplo, se pcSub for uma condição de negação com uma subcondição C, a negação dupla será resolvida logicamente e ppcResult será definido como C. Sem simplificação, a árvore resultante se pareceria com NOT — NOT — C.

Os aplicativos que precisam executar consultas com base na árvore de condição normalmente se beneficiariam da definição desse parâmetro como TRUE.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP com SP2, Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 com SP1 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	structuredquery.h
Redistribuível	Pesquisa da Área de Trabalho do Windows (WDS) 3.0