IWbemServices::P utClass 메서드(wbemcli.h)
IWbemServices::P utClass 메서드는 새 클래스를 만들거나 기존 클래스를 업데이트합니다. pObject 매개 변수로 지정된 클래스가 필요한 모든 속성 값으로 올바르게 초기화되어야 합니다.
사용자는 밑줄(_)로 시작하거나 끝나는 이름으로 클래스를 만들 수 없습니다. 시스템 클래스용으로 예약되어 있습니다.
구문
HRESULT PutClass(
[in] IWbemClassObject *pObject,
[in] long lFlags,
[in] IWbemContext *pCtx,
[out] IWbemCallResult **ppCallResult
);
매개 변수
[in] pObject
유효한 클래스 정의를 가리킬 수 있습니다. 참조 수는 변경되지 않습니다.
[in] lFlags
다음 플래그는 이 메서드의 동작에 영향을 미칩니다.
WBEM_FLAG_USE_AMENDED_QUALIFIERS
이 플래그가 설정된 경우 WMI는 수정된 버전을 가진 한정자를 저장하지 않습니다. 이 플래그가 설정되지 않은 경우 이 개체가 지역화되지 않고 모든 한정자는 이 instance 함께 저장됩니다.
WBEM_FLAG_CREATE_OR_UPDATE
이 플래그는 없는 경우 클래스를 만들거나 클래스가 이미 있는 경우 덮어씁니다.
WBEM_FLAG_UPDATE_ONLY
이 플래그를 사용하면 이 호출이 업데이트됩니다. 호출에 성공하려면 클래스가 있어야 합니다.
WBEM_FLAG_CREATE_ONLY
이 플래그는 만들기에만 사용됩니다. 클래스가 이미 있는 경우 호출이 실패합니다.
WBEM_FLAG_RETURN_IMMEDIATELY
이 플래그를 사용하면 반동기 호출이 됩니다. 자세한 내용은 메서드 호출을 참조하세요.
WBEM_FLAG_OWNER_UPDATE
푸시 공급자는 이 클래스가 변경되었음을 나타내기 위해 PutClass를 호출할 때 이 플래그를 지정해야 합니다.
WBEM_FLAG_UPDATE_COMPATIBLE
이 플래그를 사용하면 파생 클래스가 없고 해당 클래스에 대한 인스턴스가 없는 경우 클래스를 업데이트할 수 있습니다. 또한 변경 내용이 중요하지 않은 한정자(예: 설명 한정자)에만 해당되는 경우 모든 경우에 업데이트를 허용합니다. 이 호출의 기본 동작이며 이전 버전의 Windows Management와의 호환성에 사용됩니다. 클래스에 인스턴스가 있거나 중요한 한정자를 변경하면 업데이트가 실패합니다.
WBEM_FLAG_UPDATE_SAFE_MODE
이 플래그는 변경으로 인해 자식 클래스와 충돌하지 않는 한 자식 클래스가 있더라도 클래스를 업데이트할 수 있습니다. 이 플래그가 허용하는 업데이트의 예는 이전에 자식 클래스에서 언급되지 않은 기본 클래스에 새 속성을 추가하는 것입니다. 클래스에 인스턴스가 있는 경우 업데이트가 실패합니다.
WBEM_FLAG_UPDATE_FORCE_MODE
이 플래그는 충돌하는 자식 클래스가 있을 때 클래스를 강제로 업데이트합니다. 이 플래그를 강제로 업데이트하는 예는 클래스 한정자를 자식 클래스에 정의하고 기본 클래스가 기존 클래스와 충돌하는 동일한 한정자를 추가하려고 하는 경우입니다. 강제 모드에서는 자식 클래스에서 충돌하는 한정자를 삭제하여 이 충돌을 해결합니다.
[in] pCtx
일반적으로 NULL입니다. 그렇지 않으면 클래스 인스턴스를 생성하는 동적 클래스 공급자에 필요한 IWbemContext 개체에 대한 포인터입니다. 컨텍스트 개체의 값은 해당 공급자에 대한 설명서에 지정해야 합니다. 이 매개 변수에 대한 자세한 내용은 WMI 호출을 참조하세요.
[out] ppCallResult
NULL인 경우 이 매개 변수는 사용되지 않습니다. lFlags 매개 변수에 WBEM_FLAG_RETURN_IMMEDIATELY 포함된 경우 이 호출은 WBEM_S_NO_ERROR 사용하여 즉시 반환됩니다. ppCallResult 매개 변수는 새 IWbemCallResult 개체에 대한 포인터를 수신합니다. 그러면 폴링하여 IWbemCallResult::GetCallStatus 메서드를 사용하여 결과를 가져올 수 있습니다.
반환 값
이 메서드는 메서드 호출의 상태를 나타내는 HRESULT를 반환합니다. 다음 목록에는 HRESULT에 포함된 값이 나열되어 있습니다.
실패 시 COM 함수 GetErrorInfo에서 사용 가능한 정보를 가져올 수 있습니다.
네트워크 문제로 인해 Windows Management에 대한 원격 연결이 끊어지는 경우에도 COM 관련 오류 코드가 반환될 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | wbemcli.h(Wbemidl.h 포함) |
| 라이브러리 | Wbemuuid.lib |
| DLL | Fastprox.dll; Esscli.dll; FrameDyn.dll; FrameDynOS.dll; Ntevt.dll; Stdprov.dll; Viewprov.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wbemsvc.dll; Wmipicmp.dll; Wmidcprv.dll; Wmipjobj.dll; Wmiprvsd.dll |