CWbemProviderGlue::GetInstanceByPath(LPCWSTR,CInstance**,MethodContext*) 메서드(wbemglue.h)

[CWbemProviderGlue 클래스는 현재 최종 상태로 간주되는 WMI 공급자 프레임워크의 일부이며 이러한 라이브러리에 영향을 주는 비보안 관련 문제에 대해 추가 개발, 개선 또는 업데이트를 사용할 수 없습니다. 모든 새로운 개발에서는 MI API를 사용해야 합니다.]

GetInstanceByPath 메서드는 공급자 GetObject 메서드를 호출하여 특정 개체 경로로 식별되는 instance 검색합니다.

구문

HRESULT GetInstanceByPath(
  LPCWSTR       pszObjectPath,
  CInstance     **ppInstance,
  MethodContext *pMethodContext
);

매개 변수

pszObjectPath

반환할 instance 대한 개체 경로입니다.

ppInstance

새 instance 저장하는 데 사용되는 CInstance instance 대한 포인터입니다. 요청을 수행하는 프레임워크 공급자는 이 포인터를 해제해야 합니다.

pMethodContext

현재 컨텍스트에 대한 포인터입니다. 교착 상태를 방지하려면 컨텍스트를 제공해야 합니다. Provider::EnumerateInstances 또는 Provider::ExecQuery에서 공급자에 전달된 컨텍스트를 사용하거나 CInstance::GetMethodContext를 사용하여 instance 가져옵니다. 이 매개 변수는 NULL이 아니어야 합니다.

반환 값

작업이 성공하면 WBEM_S_NO_ERROR반환하고, 메모리 부족 또는 다른 HRESULT 오류 코드로 인해 작업이 실패했는지 WBEM_E_OUT_OF_MEMORY.

설명

GetInstanceByPath 메서드를 사용하면 프레임워크 공급자가 WMI API 호출 없이 다른 공급자의 데이터에 액세스할 수 있습니다. 프레임워크 공급자는 instance 반환하는 GetInstanceByPath에 instance 개체 경로를 전달합니다.

공급자 프레임워크의 현재 버전에서 pszInstancePath는 동일한 컴퓨터의 instance 경로로 resolve 합니다.

pMethodContext의 기본값은 NULL이지만 교착 상태를 방지하려면 컨텍스트를 제공해야 합니다. Provider::EnumerateInstances 또는 Provider::ExecQuery에서 공급자에 전달된 컨텍스트를 사용하거나 CInstance::GetMethodContext를 사용하여 instance 가져옵니다.

요구 사항

지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	wbemglue.h(FwCommon.h 포함)
라이브러리	FrameDyn.lib
DLL	FrameDynOS.dll; FrameDyn.dll