CInstance クラス (instance.h)

[CInstance クラスは WMI プロバイダー フレームワークの一部であり、現在最終的な状態と見なされています。これらのライブラリに影響を与える、セキュリティ関連以外の問題に対しては、それ以上の開発、機能強化、または更新プログラムは利用できません。 すべての新規開発には、MI API を使用する必要があります。]

CInstance クラスは、WMI プロバイダー フレームワークでサポートされているインスタンスに対して定義されているプロパティの値を取得および更新するために使用されます。 CInstance クラスは、プロバイダー フレームワークの CInstance インターフェイスの実装へのアクセスも提供します。

プロバイダー ライターがこのクラスから派生する必要はありません。 Provider::CreateNewInstance を使用して、このクラスのインスタンスを作成します。

CInstance には、次の種類のメンバーがあります。

メソッド	説明
コミット	現在のインスタンスを WMI に返します。
Getbool	Boolean プロパティを取得します。
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	Boolean プロパティを設定 します 。
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 メソッドはブール型 (Boolean) のプロパティを設定します。
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 を含む)