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

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

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

こちらもご覧ください

IMofCompiler

WBEM_COMPILER_OPTIONS

次の方法で共有