IMofCompiler::CompileBuffer-Methode (wbemcli.h)
Die IMofCompiler::CompileBuffer-Methode kompiliert entweder einen Puffer, der binäre MOF-Daten enthält, oder einen Textpuffer im ASCII-Format. Binäre MOF-Dateien enthalten analysierte Daten und müssen in der Datenbank gespeichert werden. Die CompileBuffer-Methode akzeptiert nur Arrays mit mehreren Bytezeichen (Zeichenfolgenpuffer), die nicht NULL-beendet sind.
Syntax
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
);
Parameter
[in] BuffSize
Größe der Daten, auf die der pBuffer-Parameter verweist.
[in] pBuffer
Zeiger auf die binären MOF-Dateidaten oder einen Textpuffer im ASCII-Format.
[in] ServerAndNamespace
Name des Servers und Namespace.
Dieser Parameter wird ignoriert, es sei denn, der pBuffer-Parameter verweist auf einen Textpuffer. Wenn der Text MOF ohne #pragma-Anweisung übergeben wird, wird die MOF-Datei in den Standardnamespace kompiliert. Wenn pBuffer auf eine binäre MOF-Datei zeigt, muss der ServerAndNamespace-ParameterNULL sein.
[in] User
Name des Benutzers, der den Dienst anfordert.
Dieser Parameter gibt die Anmeldeinformationen für die Kompilierung auf Remotecomputern an. Wenn der Wert NULL ist, entspricht der Benutzerkontext dem, was der aktuelle Prozess verwendet. Dies wird beim Herstellen einer Verbindung mit dem lokalen Computer immer ignoriert. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.
[in] Authority
Gibt die Anmeldeinformationen für die Kompilierung auf Remotecomputern an. Wenn der Wert NULL ist, entspricht der Autoritätskontext dem, was der aktuelle Prozess verwendet. Dieser Parameter wird beim Herstellen einer Verbindung mit dem lokalen Computer immer ignoriert. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.
[in] Password
Gibt die Anmeldeinformationen für die Kompilierung auf Remotecomputern an. Wenn der Wert NULL ist, wird das Kennwort des aktuellen Kontexts verwendet. Dieser Parameter wird beim Herstellen einer Verbindung mit dem lokalen Computer immer ignoriert.
[in] lOptionFlags
Sie können eines oder mehrere der folgenden Flags kombinieren.
WBEM_FLAG_CHECK_ONLY
Führt nur eine Syntaxprüfung aus.
WBEM_FLAG_AUTORECOVER
Wenn die Methode erfolgreich ist, wird der Dateiname der Liste der Dateien hinzugefügt, die während der automatischen Datenbankwiederherstellung kompiliert werden sollen.
Dieses Flag kann nicht mit den Namespace-, Klassen- oder instance-Flags kombiniert werden.
WBEM_FLAG_CONSOLE_PRINT
Sendet verschiedene nützliche Nachrichten an die Konsole.
WBEM_FLAG_DONT_ADD_TO_LIST
Verhindert das Hinzufügen der Datei zur Liste der Dateien, die während der automatischen Datenbankwiederherstellung kompiliert werden sollen.
Dieses Flag ist nicht mit WBEM_FLAG_AUTORECOVER kompatibel.
[in] lClassFlags
Dieser Parameter wird ignoriert, da die binäre MOF-Datei die Informationen bereits enthält. Der Parameterwert sollte 0 sein.
[in] lInstanceFlags
Wird ignoriert, da die binäre MOF-Datei die Informationen bereits enthält. Der Parameterwert sollte 0 sein.
[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.
Hinweise
Wenn der Parameter User das Format <domäne\user> annimmt, muss der Parameter AuthorityNULL sein.
Binäre MOF-Daten können von der CreateBMOF-Methode generiert werden, die die binären MOF-Daten in einer Datei speichert, die vor dem Aufruf der CompileBuffer-Methode gelesen werden kann.
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 |