Provider::P utInstance(constCInstance&,long) 메서드(provider.h)

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

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

구문

HRESULT PutInstance(
  [ref] const CInstance & newInstance,
        long              lFlags
);

매개 변수

[ref] newInstance

업데이트되는 인스턴스입니다.

lFlags

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

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

• WBEM_FLAG_RETURN_IMMEDIATELY

• WBEM_FLAG_CREATE_ONLY
• WBEM_FLAG_CREATE_OR_UPDATE
• WBEM_FLAG_UPDATE_ONLY

반환 값

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

설명

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

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

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

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

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

요구 사항