CompareTo 函式
將物件與另一個 Windows 管理物件比較。
注意
此 API 僅供內部使用。 不是要讓您在開發人員程式碼中使用。
語法
HRESULT CompareTo (
[in] int vFunc,
[in] IWbemClassObject* ptr,
[in] LONG flags,
[in] IWbemClassObject* pCompareTo
);
參數
vFunc
[in] 此參數未使用。
ptr
[in] IWbemClassObject 執行個體的指標。
flags
[in] 旗標的位元組合，指定要考慮進行比較的物件特性。 如需詳細資訊，請參閱備註一節。
pCompareTo
[in] 要比較的物件。 pCompareTo 必須是有效的 IWbemClassObject 執行個體；不能是 null。
傳回值
此函式傳回的下列值定義於 WbemCli.h 標頭檔中，或者，您可以將其定義為程式碼中的常數：
| 常數 | 值 | 描述 |
|---|---|---|
WBEM_E_FAILED |
0x80041001 | 發生未指定的錯誤。 |
WBEM_E_INVALID_PARAMETER |
0x80041008 | 有一個參數無效。 |
WBEM_E_UNEXPECTED |
0x8004101d | 在沒有介入呼叫 EndEnumeration 下進行第二次呼叫 BeginEnumeration。 |
WBEM_S_NO_ERROR |
0 | 函式呼叫成功。 |
WBEM_S_DIFFERENT |
0x40003 | 物件不相同。 |
WBEM_S_SAME |
0 | 根據比較旗標，物件相同。 |
備註
此函式會包裝對 IWbemClassObject::CompareTo 方法的呼叫。
可以當做 lEnumFlags 引數傳遞的旗標，會於 WbemCli.h 標頭檔中定義，或者可以將它們定義為程式碼中的常數。 您可藉由指定下列旗標的位元組合，指定與比較相關的個別特性：
| 常數 | 值 | 描述 |
|---|---|---|
WBEM_FLAG_IGNORE_OBJECT_SOURCE |
2 | 忽略來源 (伺服器及其來自的命名空間)。 |
WBEM_FLAG_IGNORE_QUALIFIERS |
1 | 忽略所有限定詞 (包括 Key 和 Dynamic) |
WBEM_FLAG_IGNORE_DEFAULT_VALUES |
4 | 忽略屬性的預設值。 此旗標僅適用於類別的比較。 |
WBEM_FLAG_IGNORE_FLAVOR |
0x20 | 忽略限定詞標註。 這個旗標仍然會考慮限定詞，但是會忽略類型差異，例如傳用原則和覆寫限制。 |
WBEM_FLAG_IGNORE_CASE |
0x10 | 忽略在比較字串值時的大小寫。 這適用於字串與限定詞值。 不論是否已設定此旗標，屬性和限定詞名稱的比較一律會區分大小寫。 |
WBEM_FLAG_IGNORE_CLASS |
0x8 | 假設正在比較的物件是相同類別的執行個體。 因此，此旗標只會比較執行個體相關資訊。 使用這個旗標，將效能最佳化。 如果物件不屬於相同類別，則結果不會定義。 |
或者，您可以指定單一複合旗標，如下所示：
| 常數 | 值 | 描述 |
|---|---|---|
WBEM_COMPARISON_INCLUDE_ALL |
0 | 請考慮比較中的所有特性。 |
規格需求
平台：請參閱系統需求。
標頭：WMINet_Utils.idl
.NET Framework版本：自 4.7.2 起可用
