次の方法で共有

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

  • [アーティクル]

IMofCompiler::CompileFile メソッドは MOF ファイル (バイナリ MOF を含む) をコンパイルし、WMI リポジトリに情報を格納します。 このメソッドは、 Mofcomp コマンドと同じ操作を実行します。

構文

HRESULT CompileFile(
  [in]      LPWSTR                   FileName,
  [in]      LPWSTR                   ServerAndNamespace,
  [in]      LPWSTR                   User,
  [in]      LPWSTR                   Authority,
  [in]      LPWSTR                   Password,
  [in]      LONG                     lOptionFlags,
  [in]      LONG                     lClassFlags,
  [in]      LONG                     lInstanceFlags,
  [in, out] WBEM_COMPILE_STATUS_INFO *pInfo
);

パラメーター

[in] FileName

コンパイルするファイルの名前。

[in] ServerAndNamespace

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

リモート コンピューター ("\computer\root"など) で名前空間を指定できます。 この値は #pragma コマンドでオーバーライドできます。自動回復が必要な場合は使用しないでください。 NULL の場合、ローカル コンピューターの root\default 名前空間が既定です。

[in] User

リモート コンピューターでのコンパイルに使用される資格情報を示す 値。 値が NULL の場合、ユーザー コンテキストは呼び出し元のプロセスで使用されているものに関係ありません。 ローカル コンピューターに接続する場合、これは常に無視されます。 詳細については、「解説」を参照してください。

[in] Authority

リモート コンピューターでコンパイルするための資格情報を指定する 値。 値が NULL の場合、機関コンテキストは呼び出し元プロセスが使用しているものに関係ありません。 ローカル コンピューターに接続する場合、これは常に無視されます。 詳細については、「解説」を参照してください。

[in] Password

リモート コンピューターでコンパイルするための資格情報を指定する 値。 値が NULL の場合は、現在のコンテキストのパスワードが使用されます。 ローカル コンピューターに接続する場合、これは常に無視されます。

[in] lOptionFlags

CompileFile メソッドを使用するときに、次のフラグの 1 つ以上の組み合わせを有効にするパラメーター。

WBEM_FLAG_CHECK_ONLY

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

WBEM_FLAG_AUTORECOVER

メソッドが成功した場合は、データベースの自動回復中にコンパイルするファイルの一覧にファイルの名前を追加します。

このフラグは、名前空間、クラス、またはインスタンス フラグと組み合わせることができないことに注意してください。

WBEM_FLAG_CONSOLE_PRINT

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

WBEM_FLAG_DONT_ADD_TO_LIST

データベースの自動回復中にコンパイルされたファイルの一覧にファイルが追加されないようにします。

このフラグは 、WBEM_FLAG_AUTORECOVERと互換性がありません。

[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

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

このフラグを llnstanceFlags と組み合わせることができます。

[in] lInstanceFlags

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

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

WBEM_FLAG_UPDATE_ONLY

更新のみを許可します。

WBEM_FLAG_CREATE_ONLY

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

[in, out] pInfo

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

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

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

2

自動回復ステートメント #pragma 存在しないことを警告します。 このステートメントは、MOF ファイルの最初の行の 1 つである必要があります。

解説

User パラメーターが domain\user> の形式の<場合、Authority パラメーターは NULL である必要があります。

要件

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

関連項目

IMofCompiler

WBEM_CHANGE_FLAG_TYPE

WBEM_COMPILER_OPTIONS

mofcomp