CInstance 클래스(instance.h)

[CInstance 클래스는 현재 최종 상태로 간주되는 WMI 공급자 프레임워크의 일부로, 이 라이브러리에 영향을 미치는 보안과 관련되지 않은 문제에 대해서는 더 이상 개발, 개선 또는 업데이트가 이루어지지 않습니다. 모든 새로운 개발에서는 MI API를 사용해야 합니다.]

CInstance 클래스는 WMI 공급자 프레임워크에서 지원하는 인스턴스에 대해 정의된 속성 값을 검색하고 업데이트하는 데 사용됩니다. 또한 CInstance 클래스는 공급자 프레임워크의 CInstance 인터페이스 구현에 대한 액세스를 제공합니다.

공급자 작성기가 이 클래스에서 파생되어야 하는 것은 아닙니다. Provider::CreateNewInstance를 사용하여 이 클래스의 instance 만듭니다.

CInstance 에는 다음과 같은 유형의 멤버가 있습니다.

메서드	Description
커밋	WMI에 대한 현재 instance 반환합니다.
Getbool	부울 속성을 검색합니다.
GetByte	BYTE 호환 속성을 검색합니다.
GetCHString	문자열 속성을 검색합니다.
GetClassObjectInterface	IWbemClassObject 인터페이스 포인터를 반환합니다.
GetDateTime	datetime 속성을 반환합니다.
GetDOUBLE	DOUBLE 속성을 검색합니다.
GetDWORD	DWORD 속성을 검색합니다.
GetEmbeddedObject	포함된 CInstance 속성을 검색합니다.
GetMethodContext	MethodContext 개체에 대한 포인터를 반환합니다.
GetStatus	속성이 있는지 여부를 확인하고, 있는 경우 해당 형식을 결정합니다.
GetStringArray	문자열 배열을 나타내는 속성을 검색합니다.
GetTimeSpan	WMI 시간 범위를 나타내는 속성을 검색합니다.
GetVariant	VARIANT 속성을 검색합니다.
GetWBEMINT16	16비트 정수 속성을 검색합니다.
GetWBEMINT64	오버로드됨. 64비트 정수 속성을 검색합니다.
GetWCHAR	WCHAR 속성을 검색합니다.
GetWORD	WORD 속성을 검색합니다.
IsNull	특정 속성의 값이 NULL인지 여부를 확인합니다.
Setbool	부울 속성을 설정합니다.
SetByte	BYTE 속성을 설정합니다.
SetCharSplat	오버로드됨. 문자열 속성을 설정합니다.
SetCHString	오버로드됨. 문자열 속성을 설정합니다.
SetDateTime	datetime 속성을 설정합니다.
SetDOUBLE	DOUBLE 속성을 설정합니다.
SetDWORD	DWORD 속성을 설정합니다.
SetEmbeddedObject	포함된 CInstance 속성을 설정합니다.
SetNull	속성을 NULL로 설정합니다.
SetStringArray	문자열 배열을 나타내는 속성을 설정합니다.
SetTimeSpan	시간 범위를 나타내는 속성을 설정합니다.
SetVariant	VARIANT 속성을 설정합니다.
SetWBEMINT16	16비트 정수 속성을 설정합니다.
SetWBEMINT64	오버로드됨. 64비트 정수 속성을 설정합니다.
SetWCHARSplat	WCHAR 문자열 속성을 설정합니다.
SetWORD	WORD 속성을 설정합니다.

메서드

CInstance 클래스에는 이러한 메서드가 있습니다.

CInstance::Commit Commit 메서드는 현재 instance WMI로 반환합니다.
CInstance::Getbool Getbool 메서드는 부울 속성을 검색합니다.
CInstance::GetByte GetByte 메서드는 BYTE 호환 속성을 검색합니다.
CInstance::GetCHString GetCHString 메서드는 문자열 속성을 검색합니다.
CInstance::GetClassObjectInterface GetClassObjectInterface 메서드는 IWbemClassObject 인터페이스 포인터를 반환합니다.
CInstance::GetDateTime GetDateTime 메서드는 datetime 속성을 반환합니다.
CInstance::GetDOUBLE GetDOUBLE 메서드는 DOUBLE 속성을 검색합니다.
CInstance::GetDWORD GetDWORD 메서드는 DWORD 속성을 검색합니다.
CInstance::GetEmbeddedObject GetEmbeddedObject 메서드는 포함된 CInstance 개체에 대한 포인터를 검색합니다. 포인터를 사용하여 포함된 개체의 속성을 가져와서 설정할 수 있습니다.
CInstance::GetMethodContext GetMethodContext 메서드는 MethodContext 개체에 대한 포인터를 반환합니다.
CInstance::GetStatus GetStatus 메서드는 속성이 있는지 여부를 확인하고, 있는 경우 해당 형식을 결정합니다.
CInstance::GetStringArray GetStringArray 메서드는 문자열 배열을 나타내는 속성을 검색합니다.
CInstance::GetTimeSpan GetTimeSpan 메서드는 WMI 시간 범위를 나타내는 속성을 검색합니다.
CInstance::GetVariant GetVariant 메서드는 VARIANT 속성을 검색합니다.
CInstance::GetWBEMINT16 GetWBEMINT16 메서드는 16비트 정수 속성을 검색합니다.
CInstance::GetWBEMINT64 GetWBEMINT64 메서드는 64비트 정수 속성을 검색합니다. (오버로드 1/3)
CInstance::GetWBEMINT64 GetWBEMINT64 메서드는 64비트 정수 속성을 검색합니다. (오버로드 3/3)
CInstance::GetWBEMINT64 GetWBEMINT64 메서드는 64비트 정수 속성을 검색합니다. (오버로드 2/3)
CInstance::GetWCHAR GetWCHAR 메서드는 WCHAR 문자열 속성을 검색합니다.
CInstance::GetWORD GetWORD 메서드는 WORD 속성을 검색합니다.
CInstance::IsNull IsNull 메서드는 특정 속성의 값이 NULL인지 여부를 결정합니다.
CInstance::Setbool Setbool 메서드는 부울 속성을 설정합니다.
CInstance::SetByte SetByte 메서드는 BYTE 속성을 설정합니다.
CInstance::SetCharSplat SetCharSplat(LPCWSTR, DWORD) 메서드는 문자열을 설정합니다.
CInstance::SetCharSplat SetCharSplat(LPCWSTR, LPCSTR) 메서드는 문자열 속성을 설정합니다.
CInstance::SetCharSplat SetCharSplat(LPCWSTR, LPCWSTR) 메서드는 문자열 속성을 설정합니다.
CInstance::SetCHString SetCHString(LPCWSTR, const CHString&) 메서드는 문자열 속성을 설정합니다. (오버로드 2/2)
CInstance::SetCHString SetCHString(LPCWSTR, LPCSTR) 메서드는 문자열 속성을 설정합니다.
CInstance::SetCHString SetCHString(LPCWSTR, const CHString&) 메서드는 문자열 속성을 설정합니다. (오버로드 1/2)
CInstance::SetDateTime SetDateTime 메서드는 datetime 속성을 설정합니다.
CInstance::SetDOUBLE CInstance::SetDOUBLE 메서드
CInstance::SetDWORD SetDWORD 메서드는 DWORD 속성을 설정합니다.
CInstance::SetEmbeddedObject SetEmbeddedObject 메서드는 포함된 CInstance 속성을 설정합니다.
CInstance::SetNull SetNull 메서드는 속성을 NULL로 설정합니다.
CInstance::SetStringArray SetStringArray 메서드는 문자열 배열을 나타내는 속성을 설정합니다.
CInstance::SetTimeSpan SetTimeSpan 메서드는 시간 범위를 나타내는 속성을 설정합니다.
CInstance::SetVariant SetVariant 메서드는 VARIANT 속성을 설정합니다.
CInstance::SetWBEMINT16 SetWBEMINT16 메서드는 16비트 정수 속성을 설정합니다.
CInstance::SetWBEMINT64 SetWBEMINT64(LPCWSTR, const LONGLONG&) 메서드는 64비트 정수 값을 설정합니다. (오버로드 3/3)
CInstance::SetWBEMINT64 SetWBEMINT64(LPCWSTR, const LONGLONG&) 메서드는 64비트 정수 값을 설정합니다. (오버로드 1/3)
CInstance::SetWBEMINT64 SetWBEMINT64(LPCWSTR, const LONGLONG&) 메서드는 64비트 정수 값을 설정합니다. (오버로드 2/3)
CInstance::SetWCHARSplat SetWCHARSplat 메서드는 문자열 속성을 설정합니다.
CInstance::SetWORD SetWORD 메서드는 WORD 속성을 설정합니다.

설명

이 클래스의 소멸자 CInstance::~CInstance입니다.

CInstance 클래스의 메서드는 속성 값을 검색하고 설정하는 데 사용됩니다. 속성 데이터 형식은 .mof 파일에서 볼 수 있는 CIM 데이터 형식을 사용하여 정의됩니다. CInstance 메서드를 사용하여 속성 값을 쿼리하거나 설정할 때는 속성의 CIM 데이터 형식과 호환되는 메서드를 사용해야 합니다. 다음 표에는 CIM 데이터 형식과 해당 데이터 형식의 속성에 액세스하기 위한 허용 가능한 CInstance get 또는 set 메서드가 나와 있습니다.

CIM 데이터 형식	CInstance Get/Set 메서드 형식
string	CHString VARIANT WCHAR CharSplat
sint8	VARIANT
uint8	BYTE
sint16	WBEMINT16 VARIANT
uint16	WORD DWORD VARIANT
sint32	WORD DWORD VARIANT
uint32	WORD DWORD VARIANT
sint64	CHString VARIANT WBEMINT64 WCHAR
uint64	CHString VARIANT WBEMINT64 WCHAR
real32	VARIANT
real64	CHString DOUBLE VARIANT
char16	VARIANT
DateTime	CHString DateTime VARIANT WCHAR

요구 사항

지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	instance.h(FwCommon.h 포함)