다음을 통해 공유

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 헤더 파일에 정의되어 있거나 코드에서 상수로 정의할 수 있습니다.

상수 값 Description
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부터 사용 가능

참고 항목

  • Last updated on