IWbemServices::GetObject 메서드(wbemcli.h)

아티클
08/27/2023

IWbemServices::GetObject 메서드는 클래스 또는 instance 검색합니다. 이 메서드는 현재 IWbemServices 개체와 연결된 네임스페이스에서만 개체를 검색합니다.

구문

HRESULT GetObject(
  [in]  const BSTR       strObjectPath,
  [in]  long             lFlags,
  [in]  IWbemContext     *pCtx,
  [out] IWbemClassObject **ppObject,
  [out] IWbemCallResult  **ppCallResult
);

매개 변수

[in] strObjectPath

검색할 개체의 경로입니다. NULL이면 새 클래스가 될 수 있는 빈 개체가 반환됩니다. 자세한 내용은 클래스 만들기를 참조하세요.

[in] lFlags

다음 플래그는 이 메서드의 동작에 영향을 미칩니다.

WBEM_FLAG_USE_AMENDED_QUALIFIERS

이 플래그가 설정되면 WMI는 현재 연결 로캘의 지역화된 네임스페이스에 저장된 수정된 한정자를 검색합니다. 설정하지 않으면 직접 네임스페이스에 저장된 한정자만 검색됩니다.

WBEM_FLAG_RETURN_WBEM_COMPLETE

이 플래그는 동기 호출을 만듭니다.

WBEM_FLAG_RETURN_IMMEDIATELY

이 플래그는 이 호출을 반동기 호출로 만듭니다. ppCallResult 매개 변수에 대한 유효한 포인터를 제공해야 합니다. 자세한 내용은 메서드 호출을 참조하세요.

WBEM_FLAG_DIRECT_READ

이 플래그는 부모 클래스 또는 서브클래스에 관계없이 지정된 클래스에 대한 공급자에 직접 액세스합니다.

[in] pCtx

일반적으로 NULL입니다. 그렇지 않으면 요청된 클래스 또는 instance 생성하는 공급자가 사용할 수 있는 IWbemContext 개체에 대한 포인터입니다. 컨텍스트 개체의 값은 해당 공급자에 대한 설명서에 지정해야 합니다. 이 매개 변수에 대한 자세한 내용은 WMI 호출을 참조하세요.

[out] ppObject

NULL이 아닌 경우 개체가 발견되면 이 개체를 받습니다. 반환된 개체의 참조 수는 양수입니다. 호출자는 개체가 더 이상 필요하지 않은 경우 Release 를 사용해야 합니다. 모든 오류의 경우 이 매개 변수는 NULL을 가리키도록 설정됩니다.

[out] ppCallResult

NULL인 경우 이 매개 변수는 사용되지 않습니다. lFlags 매개 변수에 WBEM_FLAG_RETURN_IMMEDIATELY 포함된 경우 이 호출은 WBEM_S_NO_ERROR 사용하여 즉시 반환됩니다. ppCallResult 매개 변수는 새 IWbemCallResult 개체에 대한 포인터를 수신합니다. 그러면 GetCallStatus 메서드를 사용하여 결과를 얻기 위해 폴링할 수 있습니다. 호출자는 IWbemCallResult::GetResultObject 를 호출하여 개체를 사용할 수 있게 되면 검색할 수 있습니다.

반환 값

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

실패 시 COM 함수 GetErrorInfo에서 사용 가능한 정보를 가져올 수 있습니다.

네트워크 문제로 인해 Windows Management에 대한 원격 연결이 끊어지는 경우에도 COM 관련 오류 코드가 반환될 수 있습니다.

요구 사항


지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	wbemcli.h(Wbemidl.h 포함)
라이브러리	Wbemuuid.lib
DLL	Fastprox.dll; Esscli.dll; FrameDyn.dll; FrameDynOS.dll; Ntevt.dll; Stdprov.dll; Viewprov.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wbemsvc.dll; Wmipicmp.dll; Wmidcprv.dll; Wmipjobj.dll; Wmiprvsd.dll