Метод IMofCompiler::CompileFile (wbemcli.h)
Метод IMofCompiler::CompileFile компилирует MOF-файл (включая двоичные MOF-файлы) и сохраняет сведения в репозитории WMI. Этот метод выполняет ту же операцию, что и команда Mofcomp .
Синтаксис
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
);
Параметры
[in] FileName
Имя скомпилированного файла.
[in] ServerAndNamespace
Путь к пространству имен по умолчанию, в который записываются любые классы или экземпляры.
Пространство имен можно указать на удаленном компьютере ("\computer\root", например). Это значение может быть переопределено командой #pragma и не должно использоваться, если необходимо автоматическое восстановление. Если значение РАВНО NULL, по умолчанию используется пространство имен root\default на локальном компьютере.
[in] User
Значение типа , указывающее учетные данные, используемые для компиляции на удаленных компьютерах. Если значение равно NULL, контекст пользователя — это то, что использует вызывающий процесс. Это всегда игнорируется при подключении к локальному компьютеру. Дополнительные сведения см. в разделе «Примечания».
[in] Authority
Значение типа , указывающее учетные данные для компиляции на удаленных компьютерах. Если значение равно NULL, контекст центра — это то, что использует вызывающий процесс. Это всегда игнорируется при подключении к локальному компьютеру. Дополнительные сведения см. в разделе «Примечания».
[in] Password
Значение типа , указывающее учетные данные для компиляции на удаленных компьютерах. Если значение равно NULL, используется пароль текущего контекста. Это всегда игнорируется при подключении к локальному компьютеру.
[in] lOptionFlags
Параметр, который при использовании метода CompileFile включает сочетание одного или нескольких следующих флагов.
WBEM_FLAG_CHECK_ONLY
Выполняет только синтаксическую проверка.
WBEM_FLAG_AUTORECOVER
Если метод выполнен успешно, добавляет имя файла в список файлов, которые будут компилироваться во время автоматического восстановления базы данных.
Имейте в виду, что этот флаг не может сочетаться с флагами пространства имен, класса или экземпляра.
WBEM_FLAG_CONSOLE_PRINT
Отправляет различные полезные сообщения в консоль.
WBEM_FLAG_DONT_ADD_TO_LIST
Предотвращает добавление файла в список файлов, скомпилированных во время автоматического восстановления базы данных.
Этот флаг несовместим с WBEM_FLAG_AUTORECOVER.
[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
Обновления и разрешает конфликты везде, где это возможно. Использование принудительного режима для обновления статического класса приводит к удалению всех экземпляров этого класса. При принудительном обновлении класса поставщика экземпляры класса не удаляются.
Этот флаг можно объединить с llnstanceFlags.
[in] lInstanceFlags
Флаги, управляющие созданием экземпляров.
Значения параметров могут быть либо 0, либо один из следующих флагов.
WBEM_FLAG_UPDATE_ONLY
Разрешить только обновления.
WBEM_FLAG_CREATE_ONLY
Разрешить только новые экземпляры.
[in, out] pInfo
Указатель на WBEM_COMPILE_STATUS_INFO , описывающий ошибку.
Если значение параметра не равно NULL, произошла ошибка и структура заполняется сведениями об ошибке.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
2
Предупреждение о том, что #pragma оператор автовосстановки отсутствует. Эта инструкция должна быть одной из первых строк MOF-файла.
Комментарии
Если параметр User имеет вид <домен\пользователь>, параметр Authority должен иметь значение NULL.
Требования
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | wbemcli.h (включая Wbemidl.h) |
| Библиотека | Wbemuuid.lib |
| DLL | Mofd.dll |