次の方法で共有

WbemChangeFlagEnum 列挙 (wbemdisp.h)

  • [アーティクル]

WbemChangeFlagEnum 定数は、クラスまたはインスタンスへの書き込み操作の実行方法を定義します。書き込み操作は、 SWbemObject.Put_ または SWbemServicesEx.Put_によって実行されます。 これらのフラグは、 SWbemObject.Put_ と SWbemObject.PutAsync_によって使用されます。

WMI スクリプト タイプ ライブラリ WbemDisp.tlb は、これらの定数を定義します。 Visual Basic アプリケーションはこのライブラリにアクセスできます。スクリプト言語では、Windows スクリプト ホスト (WSH) XML ファイル形式を使用しない限り、定数の値を直接使用する必要があります。 詳細については、「 WMI スクリプト タイプ ライブラリの使用」を参照してください。

構文

typedef enum WbemChangeFlagEnum {
  wbemChangeFlagCreateOrUpdate = 0,
  wbemChangeFlagUpdateOnly = 0x1,
  wbemChangeFlagCreateOnly = 0x2,
  wbemChangeFlagUpdateCompatible = 0,
  wbemChangeFlagUpdateSafeMode = 0x20,
  wbemChangeFlagUpdateForceMode = 0x40,
  wbemChangeFlagStrongValidation = 0x80,
  wbemChangeFlagAdvisory = 0x10000
} ;

定数

 
wbemChangeFlagCreateOrUpdate
値: 0
クラスまたはインスタンスが存在しない場合は作成され、既に存在する場合は上書きされます。
wbemChangeFlagUpdateOnly
値: 0x1
呼び出しを更新します。 この呼び出しを成功させるには、クラスまたはインスタンスが存在している必要があります。
wbemChangeFlagCreateOnly
値: 0x2
作成にのみ使用されます。 クラスまたはインスタンスが既に存在する場合、呼び出しは失敗します。
wbemChangeFlagUpdateCompatible
値: 0
そのクラスの派生クラスもインスタンスも存在しない場合に、クラスの更新を許可します。 また、変更が重要でない修飾子 ( Description 修飾子など) に限定されている場合は、すべてのケースで更新を行うこともできます。 クラスにインスタンスがある場合、更新は失敗します。 このフラグは、以前のバージョンの WMI との互換性のために使用されます。
wbemChangeFlagUpdateSafeMode
値: 0x20
子クラスが存在しても、変更によって子クラスで競合が発生しない場合に限り、クラスの更新を許可します。 このフラグを更新する例として、子クラスで既に説明されていない基本クラスに新しいプロパティを追加できます。 クラスにインスタンスがある場合、更新は失敗します。
wbemChangeFlagUpdateForceMode
値: 0x40
競合する子クラスが存在する場合に、強制的にクラスを更新します。

このフラグを強制的に更新する例は、クラス修飾子が子クラスで定義されていて、基底クラスが既存の修飾子と競合して同じ修飾子を追加しようとした場合です。 強制モードでは、子クラスの修飾子を削除することで、この競合が解決されます。 クラスにインスタンスがある場合、更新は失敗します。

強制モードを使用して静的クラスを更新すると、そのクラスのすべてのインスタンスが削除されます。 プロバイダー クラスに対して強制的に更新しても、 クラスのインスタンスは削除されません。
wbemChangeFlagStrongValidation
値: 0x80
: put 操作のエラーを無効なシステム インスタンスに返すようにオペレーティング システムに通知します。 このようなインスタンスの例としては、フィルター、バインディング、プロバイダーなどのイベント関連のインスタンスがあります。 既定では、これらのインスタンスが無効な場合、put 操作は成功を報告しますが、ログにエラーが報告されます。
wbemChangeFlagAdvisory
値: 0x10000

要件

要件 値
サポートされている最小のクライアント Windows Vista
サポートされている最小のサーバー Windows Server 2008
Header wbemdisp.h

関連項目

スクリプト API 定数