Método IConditionFactory2::CreateNegation (structuredquery.h)

Artigo
03/02/2024

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

Sintaxe

HRESULT CreateNegation(
  [in]  ICondition                 *pcSub,
  [in]  CONDITION_CREATION_OPTIONS cco,
  [in]  REFIID                     riid,
  [out] void                       **ppv
);

Parâmetros

[in] pcSub

Tipo: ICondition*

Um ponteiro para o subnó ICondition a ser negado. Para opções padrão, use o sinalizador CONDITION_CREATION_DEFAULT .

[in] cco

Tipo: CONDITION_CREATION_OPTIONS

A operação de criação de condição da condição folha como a enumeração CONDITION_CREATION_OPTIONS .

[in] riid

Tipo: REFIID

O IID desejado da interface de enumeração: IEnumUnknown, IEnumVARIANT ou (para uma condição de negação) IID_ICondition.

[out] ppv

Tipo: void**

Recebe um ponteiro para zero ou mais objetos ICondition e ICondition2 .

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

Simplificar logicamente 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.

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

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	structuredquery.h