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

아티클
08/27/2023

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