IMofCompiler::CreateBMOF メソッド (wbemcli.h)

[アーティクル]
08/27/2023

IMofCompiler::CreateBMOF メソッドは、バイナリ MOF ファイルを作成します。ファイルの作成は、通常の MOF ファイルを解析し、クラスとインスタンスのバイナリ表現を特別なファイル形式に格納することによって実現されます。通常、このデータバイナリラージオブジェクト (BLOB) は実行可能ファイルにリソースとして格納されます。これは後で CompileBuffer メソッドを呼び出すために抽出できます。 IMofCompiler::CreateBMOF を使用して、ローカライズされた MOF ファイル (.mfl) を作成することもできます。

構文

HRESULT CreateBMOF(
  [in]      LPWSTR                   TextFileName,
  [in]      LPWSTR                   BMOFFileName,
  [in]      LPWSTR                   ServerAndNamespace,
  [in]      LONG                     lOptionFlags,
  [in]      LONG                     lClassFlags,
  [in]      LONG                     lInstanceFlags,
  [in, out] WBEM_COMPILE_STATUS_INFO *pInfo
);

パラメーター

[in] TextFileName

解析するテキストファイルの名前。

[in] BMOFFileName

バイナリ MOF ファイル: 結果のバイナリ MOF データを格納するファイルの名前。

ローカライズされた MOF ファイル: BMOFFileName 文字列には、次のコンマ区切りの値が含まれている必要があります。

<ロケール>
ロケール情報を指定します。この値は、前のコンマで始まる必要があります。詳細については、mofcomp ユーティリティの -ADMENDMENT スイッチの説明を参照してください。
n<filename.mof>
結果のバイナリ MOF データを格納するファイルの名前。
l<filename.mfl>
結果として得られるローカライズされた MOF データを格納するファイルの名前。

たとえば、 BMOFFileName=",aMS_409,nmyFile.mof,lmyFile.mfl" などです。

[in] ServerAndNamespace

クラスまたはインスタンスが書き込まれる既定の名前空間のパス。

このパラメーターを使用して、リモートコンピューター上の名前空間 ("\computer\root"など) を指定できます。この値は、#pragma コマンドによってオーバーライドされる可能性があり、自動回復を使用する場合は使用しないでください。パラメーター値が NULL の場合、ローカルコンピューターの root\default 名前空間が既定値になります。

[in] lOptionFlags

次のフラグを 1 つ以上組み合わせることができます。

WBEM_FLAG_CHECK_ONLY

構文チェックのみを実行します。

WBEM_FLAT_CONSOLE_PRINT

コンソールにさまざまな便利なメッセージを送信します。

WBEM_FLAG_WMI_CHECK

Windows SDKの WMI セクションの一部である WMIMOFCHK プログラムを使用して、結果のバイナリ MOF ファイルに対して追加のチェックを実行します。

[in] lClassFlags

クラスの作成を制御するフラグ。パラメーター値は、0 または次のフラグの組み合わせにすることができます。

WBEM_FLAG_UPDATE_ONLY

クラスの作成を禁止します。

このフラグは、 WBEM_FLAG_UPDATE_SAFE_MODE または WBEM_FLAG_UPDATE_FORCE_MODEと組み合わせることができます。

WBEM_FLAG_CREATE_ONLY

クラスの作成のみを許可します。

これを他のフラグと組み合わせることはできません。

WBEM_FLAG_UPDATE_SAFE_MODE

競合が存在しない限り、クラスを更新します。

このフラグは 、WBEM_FLAG_UPDATE_ONLYと組み合わせることができます。

WBEM_FLAG_UPDATE_FORCE_MODE

更新し、可能な場合は競合を解決します。強制モードを使用して静的クラスを更新すると、そのクラスのすべてのインスタンスが削除されます。プロバイダークラスの更新を強制しても、クラスのインスタンスは削除されません。

このフラグは 、lInstanceFlags と組み合わせることができます。

[in] lInstanceFlags

インスタンスの作成を制御するフラグ。

パラメーター値には、0 または次のいずれかのフラグを指定できます。

WBEM_FLAG_UPDATE_ONLY

更新のみを許可します。

WBEM_FLAG_CREATE_ONLY

新しいインスタンスのみを許可します。

[in, out] pInfo

エラーを記述する WBEM_COMPILE_STATUS_INFO へのポインター。

パラメーター値が NULL でない場合は、エラーが発生し、構造体にエラー情報が入力されます。

戻り値

成功した場合、このメソッドは WBEM_S_NO_ERROR を返します。メソッドが失敗した場合は、 WBEM_S_FALSEを返します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
対象プラットフォーム	Windows
ヘッダー	wbemcli.h (Wbemidl.h を含む)
Library	Wbemuuid.lib
[DLL]	Mofd.dll