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 |
VARIANT WCHAR CharSplat |
| sint8 | VARIANT |
| uint8 | BYTE |
| sint16 |
WBEMINT16 VARIANT |
| uint16 |
WORD DWORD VARIANT |
| sint32 |
WORD DWORD VARIANT |
| uint32 |
WORD DWORD VARIANT |
| sint64 |
VARIANT WBEMINT64 WCHAR |
| uint64 |
VARIANT WBEMINT64 WCHAR |
| real32 | VARIANT |
| real64 |
DOUBLE VARIANT |
| char16 | VARIANT |
| DateTime |
DateTime VARIANT WCHAR |
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | instance.h(FwCommon.h 포함) |