다음을 통해 공유

IWSManSession::Enumerate 메서드(wsmandisp.h)

  • 아티클

테이블, 데이터 수집 또는 로그 리소스를 열거합니다. 쿼리를 만들려면 열거형에 필터 매개 변수와 언어 매개 변수를 포함합니다. IWSManResourceLocator 개체를 사용하여 쿼리를 만들 수도 있습니다. 자세한 내용은 리소스의 모든 인스턴스 열거 또는 나열을 참조하세요.

구문

HRESULT Enumerate(
  [in]           VARIANT   resourceUri,
  [in, optional] BSTR      filter,
  [in, optional] BSTR      dialect,
  [in]           long      flags,
  [out]          IDispatch **resultSet
);

매개 변수

[in] resourceUri

검색할 리소스의 식별자입니다.

다음 목록에는 이 매개 변수에 포함될 수 있는 식별자가 포함되어 있습니다.

[in, optional] filter

열거형에서 반환되는 리소스의 항목을 정의하는 필터입니다. 리소스가 열거되면 필터 조건과 일치하는 항목만 반환됩니다. 열거형에 필터 매개 변수와 언어 매개 변수를 포함하면 열거형이 쿼리로 변환됩니다.

resourceURI 매개 변수에 대한 IWSManResourceLocator 개체가 있는 경우 이 매개 변수를 사용하면 안 됩니다. 대신 IWSManResourceLocator의 선택기 및 조각 기능을 사용합니다.

[in, optional] dialect

필터에서 사용하는 언어입니다. WMI에서 사용하는 SQL의 하위 집합인 WQL은 지원되는 유일한 언어입니다.

resourceURI 매개 변수에 대한 IWSManResourceLocator 개체가 있는 경우 이 매개 변수를 사용하면 안 됩니다. 대신 IWSManResourceLocator의 선택기 및 조각 기능을 사용합니다.

[in] flags

이 매개 변수는 __WSManEnumFlags 열거형에 플래그를 포함해야 합니다. 자세한 내용은 열거형 상수를 참조하세요.

[out] resultSet

열거 결과를 포함하는 IWSManEnumerator 개체입니다.

반환 값

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

IWSManSession::Enumerate를 호출하여 열거형 작업을 시작합니다. 그런 다음, 항목의 끝이 AtEndOfStream 속성으로 표시될 때까지 반환된 IWSManEnumerator 개체를 사용하여 IWSManEnumerator::ReadItem을 호출합니다.

플래그에 열거형 상수WSManFlagHierarchyDeepBasePropsOnly 또는 WSManFlagHierarchyShallow 가 포함된 경우 Windows 원격 관리 서비스는 ERROR_WSMAN_POLYMORPHISM_MODE_UNSUPPORTED 오류 코드를 반환합니다.

열거형 중에 네트워크 호출을 제한하는 방법에 대한 자세한 내용은 BatchItems 속성을 참조하세요.

필터를 지정하는 경우 리소스의 스키마와 관련하여 유효한 문서여야 합니다. 언어 매개 변수는 선택 사항입니다. 그러나 필터 문자열이 로 <시작하지만 XML 조각이 아닌 경우 언어 매개 변수를 포함하거나 flags 매개 변수에 WSManFlagNonXmlText 플래그를 설정합니다. 자세한 내용은 열거형 상수를 참조하세요.

해당 스크립팅 메서드는 Session.Enumerate입니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista
지원되는 최소 서버 Windows Server 2008
대상 플랫폼 Windows
헤더 wsmandisp.h
라이브러리 WSManDisp.tlb
DLL WSMAuto.dll

추가 정보

IWSManEnumerator

IWSManSession

Session.Enumerate