IMofCompiler::CreateBMOF-Methode (wbemcli.h)

Artikel
08/27/2023

Die IMofCompiler::CreateBMOF-Methode erstellt eine binäre MOF-Datei. Die Dateierstellung erfolgt durch Analysieren einer regulären MOF-Datei und Speichern einer binären Darstellung der Klassen und Instanzen in einem speziellen Dateiformat. In der Regel wird dieses Blob (Data Binary Large Object) als Ressource in einer ausführbaren Datei gespeichert, die später für einen Aufruf der CompileBuffer-Methode extrahiert werden kann. Der IMofCompiler::CreateBMOF kann auch verwendet werden, um eine lokalisierte MOF-Datei (.mfl) zu erstellen.

Syntax

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
);

Parameter

[in] TextFileName

Der Name der zu analysierenden Textdatei.

[in] BMOFFileName

Binäre MOF-Datei: Der Name der Datei, in der die resultierenden binären MOF-Daten gespeichert werden sollen.

Lokalisierte MOF-Datei: Die BMOFFileName-Zeichenfolge muss die folgenden durch Trennzeichen getrennten Werte enthalten:

ein<Gebietsschema>
Gibt die Gebietsschemainformationen an. Dieser Wert muss mit einem vorangehenden Komma beginnen. Weitere Informationen finden Sie in der Beschreibung des Schalters -ADMENDMENT für das Mofcomp-Hilfsprogramm .
n<dateiname.mof>
Der Name der Datei, in der die resultierenden binären MOF-Daten gespeichert werden sollen.
l<filename.mfl>
Der Name der Datei, in der die resultierenden lokalisierten MOF-Daten gespeichert werden sollen.

Beispiel: BMOFFileName=",aMS_409,nmyFile.mof,lmyFile.mfl".

[in] ServerAndNamespace

Der Pfad des Standardnamespaces, in dem Klassen oder Instanzen geschrieben werden.

Sie können diesen Parameter verwenden, um einen Namespace auf einem Remotecomputer anzugeben ("\computer\root", z. B. ). Dieser Wert kann vom Befehl #pragma überschrieben werden und sollte nicht verwendet werden, wenn Sie die automatische Wiederherstellung verwenden. Wenn der Parameterwert NULL ist, ist der Root\Default-Namespace auf dem lokalen Computer der Standardnamespace.

[in] lOptionFlags

Sie können eines oder mehrere der folgenden Flags kombinieren.

WBEM_FLAG_CHECK_ONLY

Führt nur eine Syntaxprüfung aus.

WBEM_FLAT_CONSOLE_PRINT

Sendet verschiedene nützliche Nachrichten an die Konsole.

WBEM_FLAG_WMI_CHECK

Führt zusätzliche Überprüfungen der resultierenden binären MOF-Datei mithilfe des WMIMOFCHK-Programms durch, das Teil des WMI-Abschnitts des Windows SDK ist.

[in] lClassFlags

Die Flags, die die Erstellung von Klassen steuern. Der Parameterwert kann 0 oder eine Kombination der folgenden Flags sein.

WBEM_FLAG_UPDATE_ONLY

Verhindert die Klassenerstellung.

Sie können dieses Flag entweder mit WBEM_FLAG_UPDATE_SAFE_MODE oder WBEM_FLAG_UPDATE_FORCE_MODE kombinieren.

WBEM_FLAG_CREATE_ONLY

Erlaubt nur die Erstellung von Klassen.

Sie können dies nicht mit anderen Flags kombinieren.

WBEM_FLAG_UPDATE_SAFE_MODE

Updates die -Klasse, es sei denn, es bestehen Konflikte.

Sie können dieses Flag mit WBEM_FLAG_UPDATE_ONLY kombinieren.

WBEM_FLAG_UPDATE_FORCE_MODE

Updates und löst Konflikte nach Möglichkeit. Wenn der Erzwingungsmodus zum Aktualisieren einer statischen Klasse verwendet wird, werden alle Instanzen dieser Klasse gelöscht. Erzwingt eine Aktualisierung für eine Anbieterklasse, die keine Instanzen der -Klasse löscht.

Sie können dieses Flag mit lInstanceFlags kombinieren.

[in] lInstanceFlags

Flags, die die Erstellung von Instanzen steuern.

Der Parameterwert kann entweder 0 oder eines der folgenden Flags sein.

WBEM_FLAG_UPDATE_ONLY

Lässt nur Updates zu.

WBEM_FLAG_CREATE_ONLY

Lässt nur neue Instanzen zu.

[in, out] pInfo

Zeiger auf eine WBEM_COMPILE_STATUS_INFO , die einen Fehler beschreibt.

Wenn der Parameterwert nicht NULL ist, ist ein Fehler aufgetreten, und die Struktur wird mit Fehlerinformationen gefüllt.

Rückgabewert

Diese Methode gibt bei erfolgreicher Ausführung WBEM_S_NO_ERROR zurück. Wenn die Methode nicht erfolgreich ist, wird WBEM_S_FALSE zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	wbemcli.h (include Wbemidl.h)
Bibliothek	Wbemuuid.lib
DLL	Mofd.dll