다음을 통해 공유


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 포함)