CWbemProviderGlue::GetInstancePropertiesByPath 메서드(wbemglue.h)

  • 아티클

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

GetInstancePropertiesByPath 메서드는 지정된 속성만 채워진 특정 개체 경로로 식별된 instance 검색합니다. 채울 속성의 이름은 CHString 배열로 지정됩니다.

구문

HRESULT GetInstancePropertiesByPath(
        LPCWSTR         pszInstancePath,
        CInstance       **ppInstance,
        MethodContext   *pMethodContext,
  [ref] CHStringArray & csaProperties
);

매개 변수

pszInstancePath

반환할 instance 개체 경로입니다. 이 매개 변수는 전체 경로를 가리킵니다.

ppInstance

키가 pszInstancePath로 지정된 새 CInstance instance 대한 포인터입니다. 요청을 수행하는 프레임워크 공급자는 이 포인터를 해제해야 합니다.

pMethodContext

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

[ref] csaProperties

새 instance 복사할 속성의 이름을 포함하는 배열입니다.

반환 값

메모리 부족 또는 다른 HRESULT 오류 코드로 인해 작업이 실패한 경우 WBEM_E_OUT_OF_MEMORY 작업이 성공한 경우 WBEM_S_NO_ERROR 반환합니다.

설명

이 메서드는 부분 instance 업데이트 작업을 사용하여 지정된 개체의 지정된 속성만 요청합니다. 이는 키보다 더 많은 속성이 필요한 경우 특정 instance 검색하는 가장 효율적인 방법입니다. 일부 공급자는 부분 instance 작업을 지원하지 않습니다. 이 경우 전체 instance(키 포함)가 채워집니다. 자세한 내용은 Partial-Instance 작업 지원을 참조하세요.

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

요구 사항

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

추가 정보

CWbemProviderGlue

GetInstanceByPath

GetInstanceKeysByPath