共用方式為


(instance.h) CInstance 類別

[ CInstance 類別是 WMI 提供者架構的一部分,它現在被視為最終狀態,而且不會針對影響這些連結庫的非安全性相關問題提供進一步的開發、增強功能或更新。 MI API 應該用於所有新的開發。]

CInstance 類別可用來擷取和更新 WMI 提供者架構所支援之實例所定義的屬性值。 CInstance 類別也可讓您存取提供者架構的 CInstance 介面實作。

提供者寫入器不需要衍生自這個類別。 使用 Provider::CreateNewInstance 來建立此類別的實例。

CInstance 具有下列類型的成員:

方法 Description
提交 將目前的實例傳回 WMI。
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 方法會將目前的實例傳回至 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 取得或設定方法來存取該資料類型的屬性。

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)