Provider::P utInstance(IWbemClassObject*,long,MethodContext*) 메서드(provider.h)

[Provider 클래스는 현재 최종 상태로 간주되는 WMI 공급자 프레임워크의 일부이며 라이브러리에 영향을 미치는 비보안 관련 문제에 대해서는 더 이상 개발, 개선 또는 업데이트를 사용할 수 없습니다. 모든 새로운 개발에서는 MI API를 사용해야 합니다.]

PutInstance 메서드는 instance 업데이트합니다.

구문

HRESULT PutInstance(
  IWbemClassObject *pInst,
  long             lFlags,
  MethodContext    *pContext
);

매개 변수

pInst

TBD

lFlags

업데이트 작업에 대한 정보가 포함된 플래그의 비트 마스크입니다. IWbemServices::P utInstance 메서드에서 클라이언트가 지정한 값입니다.

다음 플래그는 WMI에 의해 처리되고 필터링됩니다.

• WBEM_FLAG_RETURN_IMMEDIATELY

유효한 lFlags 값은 다음과 같습니다.

• WBEM_FLAG_CREATE_ONLY
• WBEM_FLAG_CREATE_OR_UPDATE
• WBEM_FLAG_UPDATE_ONLY

pContext

TBD

반환 값

이 메서드의 기본 프레임워크 공급자 구현은 호출 메서드에 WBEM_E_PROVIDER_NOT_CAPABLE 반환합니다. COM 반환 코드를 반환하도록 선택할 수 있지만 IWbemServices::P utInstance 메서드는 가장 일반적인 반환 값을 나열합니다.

설명

WMI는 클라이언트가 클래스에 대해 IWbemServices::P utInstance를 호출할 때 PutInstance를 호출합니다. 프레임워크 공급자가 인스턴스를 업데이트하는 경우 PutInstance 를 구현해야 합니다. 다음 목록에서는 PutInstance의 일반적인 구현을 설명합니다.

1. CInstance::GetCHString과 같은 CInstance에 대한 Get 메서드를 사용하여 클라이언트에서 전달한 키 속성을 검사합니다.

   구현은 공급자가 클라이언트에서 요청한 변경 내용을 지원하는지 여부를 결정해야 합니다.

2. 필요에 따라 적절한 관리되는 개체를 만들거나 업데이트합니다.
3. 적절한 반환 값을 반환합니다.

   공급자가 클라이언트에서 요청한 변경 내용을 지원하지 않는 경우 적절한 오류 코드를 반환해야 합니다. 유효한 오류 코드의 전체 목록은 IWbemServices::P utInstance를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	provider.h(FwCommon.h 포함)
라이브러리	FrameDyn.lib
DLL	FrameDynOS.dll; FrameDyn.dll