다음을 통해 공유


IWbemRefresher::Refresh 메서드(wbemcli.h)

IWbemRefresher::Refresh 메서드는 새로 고칠 수 있는 모든 개체, 열거자 및 중첩된 새로 고침을 업데이트합니다. WMI Refresher는 새로 고침에 대한 클라이언트 요청에 대한 응답으로 이 함수를 호출합니다.

구문

HRESULT Refresh(
  [in] long lFlags
);

매개 변수

[in] lFlags

이 메서드의 동작을 수정하는 플래그의 비트 마스크입니다.

WBEM_FLAG_REFRESH_AUTO_RECONNECT 지정하고 연결이 끊어지면 새로 고침이 공급자에 자동으로 다시 연결하려고 시도합니다. 이 메서드의 기본 동작입니다.

새로 고침에서 공급자에 다시 연결하지 않으려면 WBEM_FLAG_REFRESH_NO_AUTO_RECONNECT 지정합니다.

반환 값

이 메서드는 메서드 호출의 상태를 나타내는 HRESULT를 반환합니다. 다음 목록에는 HRESULT 내에 포함된 값이 나열되어 있습니다.

설명

열거자 및 개체를 새로 고치는 경우 공급자는 가능한 한 적은 시간이 소요됩니다. 다시 사용하기 위해 IWbemObjectAccess 메서드 및 캐싱 속성 핸들을 사용하면 성능이 크게 향상될 수 있습니다. 열거자를 업데이트할 때 공급자는 모든 개체를 제거 및 다시 인스턴스화하거나 변경된 인스턴스를 제거하고 추가할 수 있습니다. 최상의 방법을 선택하는 것은 사용자에게 달려 있습니다. 두 경우 모두 캐싱 인스턴스는 성능을 향상시킬 수 있습니다.

공급자는 IWbemRefresher::Refresh에 대한 호출에 대한 응답으로 리프레셔의 개체 및 열거자만 액세스해야 합니다. 그러나 새로 고침 이 호출되는 시기를 준비하기 위해 이러한 개체를 채울 데이터에 대한 백그라운드 스레드 폴링이 있는 것이 완벽하게 유효합니다.

예제

다음 코드 예제에서는 새로 고침을 구현하는 방법을 설명합니다.

HRESULT CMyHiPerfProviderRefresher::Refresh(
/* [in] */long lFlags
)
{
  // Run through all the objects and update their
  // data.

  // Now run through the enumerators.
  // Empty the enumerator and refill it.
   

  return WBEM_S_NO_ERROR;
}

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Vista
지원되는 최소 서버 Windows Server 2008
대상 플랫폼 Windows
헤더 wbemcli.h(Wbemidl.h 포함)
라이브러리 Wbemuuid.lib

추가 정보

WMI 공급자 개발

IWbemHiPerfProvider

IWbemRefresher

인스턴스 공급자를 고성능 공급자로 만들기

성능 카운터 공급자

인스턴스 공급자 작성