IMofCompiler::CompileFile-Methode (wbemcli.h)
Die IMofCompiler::CompileFile-Methode kompiliert eine MOF-Datei (einschließlich binärer MOFs) und speichert die Informationen im WMI-Repository. Diese Methode führt den gleichen Vorgang wie der Mofcomp-Befehl aus.
Syntax
HRESULT CompileFile(
[in] LPWSTR FileName,
[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
);
Parameter
[in] FileName
Der Name der zu kompilierenden Datei.
[in] ServerAndNamespace
Der Pfad zum Standardnamespace, in dem alle Klassen oder instance geschrieben werden.
Sie können einen Namespace auf einem Remotecomputer angeben ("\computer\root", z. B.). Dieser Wert kann vom Befehl #pragma überschrieben werden und sollte nicht verwendet werden, wenn die automatische Wiederherstellung gewünscht ist. Bei NULL ist der Namespace root\default auf dem lokalen Computer der Standardnamespace.
[in] User
Ein Wert, der die Anmeldeinformationen angibt, die zum Kompilieren auf Remotecomputern verwendet werden. Wenn der Wert NULL ist, entspricht der Benutzerkontext dem, was der aufrufende Prozess verwendet. Dies wird beim Herstellen einer Verbindung mit dem lokalen Computer immer ignoriert. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.
[in] Authority
Ein Wert, der die Anmeldeinformationen für die Kompilierung auf Remotecomputern angibt. Wenn der Wert NULL ist, entspricht der Autoritätskontext dem, was der aufrufende Prozess verwendet. Dies wird beim Herstellen einer Verbindung mit dem lokalen Computer immer ignoriert. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.
[in] Password
Ein Wert, der die Anmeldeinformationen für die Kompilierung auf Remotecomputern angibt. Wenn der Wert NULL ist, wird das Kennwort des aktuellen Kontexts verwendet. Dies wird beim Herstellen einer Verbindung mit dem lokalen Computer immer ignoriert.
[in] lOptionFlags
Ein Parameter, der bei Verwendung der CompileFile-Methode die Kombination eines oder mehrerer der folgenden Flags ermöglicht.
WBEM_FLAG_CHECK_ONLY
Führt nur eine Syntaxprüfung durch.
WBEM_FLAG_AUTORECOVER
Wenn die Methode erfolgreich ist, fügt der Liste der Dateien, die während der automatischen Datenbankwiederherstellung kompiliert werden sollen, den Namen der Datei hinzu.
Beachten Sie, dass dieses Flag nicht mit dem Namespace, der Klasse oder instance-Flags kombiniert werden kann.
WBEM_FLAG_CONSOLE_PRINT
Sendet verschiedene nützliche Nachrichten an die Konsole.
WBEM_FLAG_DONT_ADD_TO_LIST
Verhindert, dass die Datei der Liste der Dateien hinzugefügt wird, die während der automatischen Datenbankwiederherstellung kompiliert wurden.
Dieses Flag ist nicht mit WBEM_FLAG_AUTORECOVER kompatibel.
[in] lClassFlags
Die Flags, die die Erstellung von Klassen steuern.
Parameter können 0 oder eine Kombination der folgenden Werte sein.
WBEM_FLAG_UPDATE_ONLY
Verhindert das Erstellen einer Klasse.
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 dürfen dieses Flag nicht mit den anderen Flags kombinieren.
WBEM_FLAG_UPDATE_SAFE_MODE
Updates die Klasse, sofern keine Konflikte vorliegen.
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. Erzwingen der Aktualisierung für eine Anbieterklasse löscht keine Instanzen der -Klasse.
Sie können dieses Flag mit llnstanceFlags kombinieren.
[in] lInstanceFlags
Die Flags, die die Erstellung von Instanzen steuern.
Parameterwerte können entweder 0 oder eines der folgenden Flags sein.
WBEM_FLAG_UPDATE_ONLY
Lassen Sie nur Updates zu.
WBEM_FLAG_CREATE_ONLY
Lassen Sie 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 kann einen dieser Werte zurückgeben.
2
Warnung , dass #pragma autorecover-Anweisung nicht vorhanden ist. Diese Anweisung sollte eine der ersten Zeile der MOF-Datei sein.
Hinweise
Wenn der User-Parameter die Form domäne <\user> aufweist, muss der Authority-ParameterNULL sein.
Anforderungen
| 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 |