CWbemProviderGlue::GetInstanceKeysByPath 메서드(wbemglue.h)
[CWbemProviderGlue 클래스는 현재 최종 상태로 간주되는 WMI 공급자 프레임워크의 일부이며 이러한 라이브러리에 영향을 주는 비보안 관련 문제에 대해 추가 개발, 개선 또는 업데이트를 사용할 수 없습니다. 모든 새로운 개발에서는 MI API를 사용해야 합니다.]
GetInstanceKeysByPath 메서드는 키 속성만 채워진 특정 개체 경로로 식별된 instance 검색합니다.
구문
HRESULT GetInstanceKeysByPath(
LPCWSTR pszInstancePath,
CInstance **ppInstance,
MethodContext *pMethodContext
);
매개 변수
pszInstancePath
반환할 instance 대한 개체 경로입니다.
ppInstance
키가 pszInstancePath에 지정된 새 CInstance instance 대한 포인터에 대한 포인터입니다. 요청을 수행하는 프레임워크 공급자는 이 포인터를 해제해야 합니다.
pMethodContext
현재 컨텍스트에 대한 포인터입니다. 교착 상태를 방지하려면 컨텍스트를 제공해야 합니다. Provider::EnumerateInstances 또는 Provider::ExecQuery에서 공급자에 전달된 컨텍스트를 사용하거나 CInstance::GetMethodContext를 사용하여 instance 가져옵니다. 이 매개 변수는 NULL이 아니어야 합니다.
반환 값
메모리 부족 또는 다른 HRESULT 오류 코드로 인해 작업이 실패한 경우 WBEM_E_OUT_OF_MEMORY 작업이 성공한 경우 WBEM_S_NO_ERROR 반환합니다.
설명
이 메서드는 부분 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 |