Condividi tramite

Funzione CompareTo

  • Articolo

Confronta un oggetto con un altro oggetto di Gestione Windows.

Nota

Questa API è solo per uso interno. Non è destinata all'uso dal codice dello sviluppatore.

Sintassi

HRESULT CompareTo (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LONG              flags,
   [in] IWbemClassObject* pCompareTo
);

Parametri

vFunc
[in] Questo parametro è inutilizzato.

ptr
[in] Puntatore a un'istanza di IWbemClassObject .

flags
[in] Combinazione bit per bit dei flag che specificano le caratteristiche dell'oggetto da considerare per il confronto. Per altre informazioni, vedere la sezione Osservazioni .

pCompareTo
[in] Oggetto per il confronto. pCompareTo deve essere un'istanza IWbemClassObject valida; non può essere null.

Valore restituito

I valori seguenti restituiti da questa funzione sono definiti nel file di intestazione WbemCli.h oppure è possibile definirli come costanti nel codice:

Costante Valore Descrizione
WBEM_E_FAILED 0x80041001 Si è verificato un errore non specificato.
WBEM_E_INVALID_PARAMETER 0x80041008 Un parametro non è valido.
WBEM_E_UNEXPECTED 0x8004101d Una seconda chiamata a BeginEnumeration è stata effettuata senza una chiamata di intervento a EndEnumeration.
WBEM_S_NO_ERROR 0 La chiamata alla funzione ha avuto esito positivo.
WBEM_S_DIFFERENT 0x40003 Gli oggetti sono diversi.
WBEM_S_SAME 0 Gli oggetti sono uguali in base ai flag di confronto.

Commenti

Questa funzione esegue il wrapping di una chiamata al metodo IWbemClassObject::CompareTo .

I flag che possono essere passati come lEnumFlags argomento sono definiti nel file di intestazione WbemCli.h oppure è possibile definirli come costanti nel codice. È possibile specificare le singole caratteristiche coinvolte nel confronto specificando una combinazione bit per bit dei flag seguenti:

Costante Valore Descrizione
WBEM_FLAG_IGNORE_OBJECT_SOURCE 2 Ignorare l'origine (il server e lo spazio dei nomi da cui provengono).
WBEM_FLAG_IGNORE_QUALIFIERS 1 Ignorare tutti i qualificatori (inclusi Key e Dynamic)
WBEM_FLAG_IGNORE_DEFAULT_VALUES 4 Ignorare i valori predefiniti delle proprietà. Questo flag si applica solo al confronto delle classi.
WBEM_FLAG_IGNORE_FLAVOR 0x20 Ignorare i sapori qualificatori. Questo flag tiene ancora conto dei qualificatori, ma ignora le distinzione del sapore, ad esempio le regole di propagazione e le restrizioni di override.
WBEM_FLAG_IGNORE_CASE 0x10 Ignorare il caso nel confronto dei valori di stringa. Questo vale sia per le stringhe che per i valori qualificatori. Il confronto tra nomi di proprietà e qualificatori è sempre distinzione tra maiuscole e minuscole indipendentemente dal fatto che questo flag sia impostato.
WBEM_FLAG_IGNORE_CLASS 0x8 Si supponga che gli oggetti confrontati siano istanze della stessa classe. Di conseguenza, questo flag confronta solo le informazioni correlate all'istanza. Usare questo flag per ottimizzare le prestazioni. Se gli oggetti non appartengono alla stessa classe, i risultati sono indefiniti.

In alternativa, è possibile specificare un singolo flag composito come indicato di seguito:

Costante Valore Descrizione
WBEM_COMPARISON_INCLUDE_ALL 0 Prendere in considerazione tutte le funzionalità nel confronto.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: WMINet_Utils.idl

Versioni di .NET Framework: Disponibile da 4.7.2

Vedi anche