IMofCompiler::CompileBuffer メソッド (wbemcli.h)
IMofCompiler::CompileBuffer メソッドは、バイナリ MOF データを含むバッファーまたは ASCII 形式のテキスト バッファーをコンパイルします。 バイナリ MOF ファイルには解析されたデータが含まれており、データベースに格納する必要があります。 CompileBuffer メソッドは、NULL で終了しないマルチバイト文字配列 (文字列バッファー) のみを受け入れます。
構文
HRESULT CompileBuffer(
[in] long BuffSize,
[in] BYTE *pBuffer,
[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] BuffSize
pBuffer パラメーターによって指されるデータのサイズ。
[in] pBuffer
バイナリ MOF ファイル データまたは ASCII 形式のテキスト バッファーへのポインター。
[in] ServerAndNamespace
サーバーと名前空間の名前。
pBuffer パラメーターがテキスト バッファーを指していない限り、このパラメーターは無視されます。 テキスト MOF が #pragma ステートメントなしで渡された場合、MOF ファイルは既定の名前空間にコンパイルされます。 pBuffer がバイナリ MOF ファイルを指している場合、ServerAndNamespace パラメーターは NULL である必要があります。
[in] User
サービスを要求しているユーザーの名前。
このパラメーターは、リモート コンピューターでコンパイルするための資格情報を指定します。 値が NULL の場合、ユーザー コンテキストは現在のプロセスで使用されているものです。 ローカル コンピューターに接続する場合、これは常に無視されます。 詳細については、「解説」を参照してください。
[in] Authority
リモート コンピューターでコンパイルするための資格情報を指定します。 値が NULL の場合、機関コンテキストは現在のプロセスで使用されているものです。 ローカル コンピューターに接続する場合、このパラメーターは常に無視されます。 詳細については、「解説」を参照してください。
[in] Password
リモート コンピューターでコンパイルするための資格情報を指定します。 値が NULL の場合は、現在のコンテキストのパスワードが使用されます。 ローカル コンピューターに接続する場合、このパラメーターは常に無視されます。
[in] lOptionFlags
次のフラグを 1 つ以上組み合わせることができます。
WBEM_FLAG_CHECK_ONLY
構文チェックのみを実行します。
WBEM_FLAG_AUTORECOVER
メソッドが成功すると、データベースの自動回復中にコンパイルされるファイルの一覧にファイル名が追加されます。
このフラグを名前空間、クラス、またはインスタンス フラグと組み合わせることはできません。
WBEM_FLAG_CONSOLE_PRINT
コンソールにさまざまな便利なメッセージを送信します。
WBEM_FLAG_DONT_ADD_TO_LIST
データベースの自動回復中にコンパイルされるファイルの一覧にファイルが追加されないようにします。
このフラグは 、WBEM_FLAG_AUTORECOVERと互換性がありません。
[in] lClassFlags
バイナリ MOF ファイルに情報が既に含まれているため、このパラメーターは無視されます。 パラメーター値は 0 にする必要があります。
[in] lInstanceFlags
バイナリ MOF ファイルに情報が既に含まれているため、無視されます。 パラメーター値は 0 にする必要があります。
[in, out] pInfo
エラーを記述する WBEM_COMPILE_STATUS_INFO へのポインター。
パラメーター値が NULL でない場合は、エラーが発生し、構造体にエラー情報が入力されます。
戻り値
成功した場合、このメソッドは WBEM_S_NO_ERROR を返します。 メソッドが失敗した場合は、 WBEM_S_FALSEを返します。
注釈
User パラメーターが domain\user> という形式<の場合、Authority パラメーターは NULL である必要があります。
バイナリ MOF データは、CompileBuffer メソッドを呼び出す前に読み取ることができるファイルにバイナリ MOF データを格納する CreateBMOF メソッドによって生成できます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | wbemcli.h (Wbemidl.h を含む) |
| Library | Wbemuuid.lib |
| [DLL] | Mofd.dll |