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 |
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 を含む) |