iMofCompiler::CreateBMOF 方法 (wbemcli.h)
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資料的檔名。
[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 |