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 |