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

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

GetEmptyInstance 메서드는 지정된 클래스의 채워지지 않은 단일 인스턴스를 검색합니다.

구문

HRESULT GetEmptyInstance(
  MethodContext *pMethodContext,
  LPCWSTR       pszClassName,
  CInstance     **ppInstance,
  LPCWSTR       pszNamespace
);

매개 변수

pMethodContext

현재 컨텍스트에 대한 포인터입니다.

pszClassName

instance 반환할 클래스의 이름입니다.

ppInstance

새 instance 저장하는 데 사용되는 CInstance 클래스의 instance 대한 포인터입니다. 이 포인터는 GetEmptyInstance를 호출하는 프레임워크 공급자가 해제해야 합니다.

pszNamespace

pszClassName으로 지정된 클래스 이름의 네임스페이스입니다. 이 매개 변수는 root\cimv2인 기본 네임스페이스를 나타내는 NULL 일 수 있습니다.

반환 값

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

설명

프레임워크 공급자는 빈 instance 반환하는 GetEmptyInstance에 공급자의 이름을 전달합니다. 이 메서드의 일반적인 용도는 포함된 개체 속성을 채우는 것입니다. 이 메서드는 CInstance::SetEmbeddedObject와 함께 사용됩니다.

두 번째 함수 프로토타입은 권장되지 않습니다. 기존 코드를 지원하기 위해만 제공됩니다.

요구 사항

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