다음을 통해 공유

CreateInstanceEnumWmi 함수

지정된 선택 조건을 충족하는 지정된 클래스의 인스턴스를 반환하는 열거자를 반환합니다.

참고

이 API는 내부 전용입니다. 개발자 코드에서 사용할 수 없습니다.

구문

HRESULT CreateInstanceEnumWmi (
   [in] BSTR                    strFilter,
   [in] long                    lFlags,
   [in] IWbemContext*           pCtx,
   [out] IEnumWbemClassObject** ppEnum,
   [in] DWORD                   authLevel,
   [in] DWORD                   impLevel,
   [in] IWbemServices*          pCurrentNamespace,
   [in] BSTR                    strUser,
   [in] BSTR                    strPassword,
   [in] BSTR                    strAuthority
);

매개 변수

strFilter
[in] 인스턴스가 필요한 클래스의 이름입니다. 이 매개 변수는 null일 수 없습니다.

lFlags
[in] 이 함수의 동작에 영향을 주는 플래그의 조합입니다. 다음 값은 WbemCli.h 헤더 파일에 정의되어 있거나 코드에서 상수로 정의할 수 있습니다.

상수 값 Description
WBEM_FLAG_USE_AMENDED_QUALIFIERS 0x20000 설정되면 함수는 현재 연결 로캘의 지역화된 네임스페이스에 저장된 수정된 한정자를 검색합니다.
설정되지 않은 경우 함수는 직접 네임스페이스에 저장된 한정자만 검색합니다.
WBEM_FLAG_DEEP 0 열거형에는 이 항목과 계층 구조의 모든 하위 클래스가 포함됩니다.
WBEM_FLAG_SHALLOW 1 열거형은 이 클래스의 순수 인스턴스만 포함하고 이 클래스에서 찾을 수 없는 속성을 제공하는 하위 클래스의 모든 인스턴스를 제외합니다.
WBEM_FLAG_RETURN_IMMEDIATELY 0x10 플래그는 일부 동기 호출을 유발합니다.
WBEM_FLAG_FORWARD_ONLY 0x20 이 함수는 정방향 전용 열거자를 반환합니다. 일반적으로 순방향 전용 열거자는 기존 열거자보다 더 빠르고 메모리를 덜 사용하지만 Clone 호출을 허용하지 않습니다.
WBEM_FLAG_BIDIRECTIONAL 0 WMI는 해제될 때까지 열거형의 개체에 대한 포인터를 유지합니다.

최상의 성능을 위해 권장되는 플래그는 WBEM_FLAG_RETURN_IMMEDIATELY 및 WBEM_FLAG_FORWARD_ONLY입니다.

pCtx
[in] 일반적으로 이 값은 null입니다. 그렇지 않으면 요청된 인스턴스를 제공하는 공급자가 사용할 수 있는 IWbemContext 인스턴스에 대한 포인터입니다.

ppEnum
[out] 열거자에 대한 포인터를 받습니다.

authLevel
[in] 권한 부여 수준입니다.

impLevel
[in] 가장 수준입니다.

pCurrentNamespace
[in] 현재 네임스페이스를 나타내는 IWbemServices 개체에 대한 포인터입니다.

strUser
[in] 사용자 이름입니다. 자세한 내용은 ConnectServerWmi 함수를 참조하세요.

strPassword
[in] 암호입니다. 자세한 내용은 ConnectServerWmi 함수를 참조하세요.

strAuthority
[in] 사용자의 도메인 이름입니다. 자세한 내용은 ConnectServerWmi 함수를 참조하세요.

반환 값

이 함수가 반환하는 다음 값은 WbemCli.h 헤더 파일에 정의되어 있거나 코드에서 상수로 정의할 수 있습니다.

상수 값 Description
WBEM_E_ACCESS_DENIED 0x80041003 사용자에게 지정된 클래스의 인스턴스를 볼 수 있는 권한이 없습니다.
WBEM_E_FAILED 0x80041001 알 수 없는 오류가 발생했습니다.
WBEM_E_INVALID_CLASS 0x80041010 strFilter가 없는 경우
WBEM_E_INVALID_PARAMETER 0x80041008 매개 변수가 잘못된 경우
WBEM_E_OUT_OF_MEMORY 0x80041006 메모리가 부족 하 여 작업을 완료할 수 없습니다.
WBEM_E_SHUTTING_DOWN 0x80041033 WMI가 중지되었다가 다시 시작되었을 수 있습니다. ConnectServerWmi를 다시 호출합니다.
WBEM_E_TRANSPORT_FAILURE 0x80041015 현재 프로세스와 WMI 간의 RPC(원격 프로시저 호출) 링크가 실패했습니다.
WBEM_S_NO_ERROR 0 함수 호출에 성공했습니다.

설명

이 함수는 IWbemServices::CreateClassEnum 메서드에 대한 호출을 래핑합니다.

반환된 열거자에는 요소가 0일 수 있습니다.

함수 호출이 실패하면 GetErrorInfo 함수를 호출하여 추가 오류 정보를 얻을 수 있습니다.

요구 사항

플랫폼:시스템 요구 사항을 참조하세요.

헤더: WMINet_Utils.idl

.NET Framework 버전: 4.7.2부터 사용 가능

참고 항목

  • Last updated on