iMofCompiler：：CreateBMOF 方法 (wbemcli.h)

發行項
03/13/2024

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

您可以結合下列一或多個旗標。

WBEM_FLAG_CHECK_ONLY

只執行語法檢查。

WBEM_FLAT_CONSOLE_PRINT

將各種有用的訊息傳送至主控台。

WBEM_FLAG_WMI_CHECK

使用WMIMOFC HK 程式對產生的二進位MOF檔案執行其他檢查，這是 Windows SDK WMI 區段的一部分。

[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)
程式庫	Wbemuuid.lib
Dll	Mofd.dll