IWbemConfigureRefresher::AddEnum 메서드(wbemcli.h)

IWbemConfigureRefresher::AddEnum 메서드는 요청된 새로 고침에 열거자를 추가합니다.

구문

HRESULT AddEnum(
  [in]  IWbemServices   *pNamespace,
  [in]  LPCWSTR         wszClassName,
  [in]  long            lFlags,
  [in]  IWbemContext    *pContext,
  [out] IWbemHiPerfEnum **ppEnum,
  [out] long            *plId
);

매개 변수

[in] pNamespace

IWbemServices는 공급자가 수행한 모든 요청을 처리할 수 있는 Windows Management에 대한 포인터입니다. 메서드가 실행 중에 Windows Management로 다시 호출해야 하는 경우 공급자는 pNamespace 포인터를 사용하여 AddRef를 호출해야 합니다.

[in] wszClassName

열거된 클래스의 이름을 포함하는 16비트 유니코드 문자의 null로 끝나는 상수 문자열입니다.

[in] lFlags

이 메서드의 동작을 수정하는 플래그의 비트 마스크입니다. 이 매개 변수가 WBEM_FLAG_USE_AMENDED_QUALIFIERS 설정된 경우 반환된 인스턴스에는 지역화된 한정자(사용 가능한 경우)가 포함됩니다.

[in] pContext

일반적으로 NULL; 그렇지 않으면 하나 이상의 동적 클래스 공급자에 필요한 IWbemContext 개체에 대한 포인터입니다. 컨텍스트 개체의 값은 특정 공급자 설명서에 지정해야 합니다. 이 매개 변수에 대한 자세한 내용은 WMI 호출을 참조하세요.

[out] ppEnum

열거형을 포함할 IWbemHiPerfEnum 개체에 대한 참조를 보유하는 포인터입니다. 클라이언트는 더 이상 필요하지 않은 경우 이 포인터에서 Release 를 호출해야 합니다.

[out] plId

새로 고칠 수 있는 열거형을 고유하게 식별하는 공급자가 반환한 정수에 대한 포인터입니다.

반환 값

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

설명

제공된 클래스는 High-Performance Provider에서 제공하는 유효한 클래스를 지정해야 합니다. 호출 후 반환된 열거자의 모든 인스턴스를 쿼리할 수 있습니다. 새로 고침을 호출할 때마다 열거자의 인스턴스 수가 달라질 수 있습니다. 지정된 클래스 이름의 인스턴스만 반환됩니다. 자세한 열거형은 지원되지 않으므로 지정된 클래스의 하위 클래스는 열거되지 않습니다. 새로 고침 작업이 진행되는 동안 클라이언트에서 반환된 열거자를 터치해서는 안 됩니다. 반환된 식별자는 Remove 함수에서 개체를 제거하는 데 사용할 수 있습니다. 사용자가 추가된 열거자를 명시적으로 제거할 필요는 없습니다. 그러나 클라이언트는 더 이상 필요하지 않은 경우 반환된 열거자에서 Release 를 호출해야 합니다.

요구 사항

추가 정보

IWbemConfigureRefresher