(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)