IWbemContext::Next 메서드(wbemcli.h)
IWbemContext::Next 메서드는 IWbemContext::BeginEnumeration으로 시작하는 모든 컨텍스트 값의 열거형에서 다음 값을 검색합니다.
구문
HRESULT Next(
[in] long lFlags,
[out] BSTR *pstrName,
[out] VARIANT *pValue
);
매개 변수
[in] lFlags
예약되어 있습니다. 이 매개 변수는 0이어야 합니다.
[out] pstrName
이 매개 변수는 NULL일 수 없습니다. 포인터는 항목에서 활성 BSTR 을 가리키지 않아야 하며 이상적으로 는 NULL을 가리키도록 설정해야 합니다. 오류 코드가 반환되지 않으면 컨텍스트 값 이름을 포함하는 새로 할당된 BSTR 을 가리키도록 설정됩니다.
호출자는 더 이상 필요하지 않은 경우 반환된 문자열에서 SysFreeString 을 호출해야 합니다. WBEM_S_NO_MORE_DATA 반환되면 pstrName이 NULL을 가리키도록 설정됩니다. 이 경우 SysFreeString을 호출하면 안 됩니다. pstrName이 항목에서 유효한 BSTR을 가리키는 경우 이 BSTR은 해제되지 않으며 메모리 누수가 발생합니다.
[out] pValue
이 매개 변수는 NULL일 수 없으며 비어 있거나 초기화되지 않은 VARIANT를 가리킵니다. 오류가 반환되지 않으면 VARIANT 가 VariantInit을 사용하여 초기화된 다음 컨텍스트 값을 포함하도록 설정됩니다. 값이 더 이상 필요하지 않은 경우 호출자는 이 포인터에서 VariantClear 를 호출해야 합니다. 오류 코드가 반환되면 pValue가 가리키는 VARIANT는 수정되지 않은 상태로 유지됩니다.
WBEM_S_NO_MORE_DATA 반환하는 경우 이 매개 변수는 VT_NULL 형식의 VARIANT를 가리키도록 설정됩니다.
VARIANT 내에서 전체 IWbemClassObject개체가 반환될 수 있습니다. 이 경우 VT_UNKNOWNVARIANT 형식입니다. 호출자는 IUnknown 포인터를 사용하고 QueryInterface 를 실행하여 IWbemClassObject 포인터를 가져올 수 있습니다.
반환 값
이 메서드는 메서드 호출의 상태를 나타내는 HRESULT를 반환합니다. 다음 목록에는 HRESULT 내에 포함된 값이 나열되어 있습니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | wbemcli.h(Wbemidl.h 포함) |
| 라이브러리 | Wbemuuid.lib |
| DLL | Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wmipjobj.dll |