Метод 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

См. также раздел

IMofCompiler

WBEM_CHANGE_FLAG_TYPE

WBEM_COMPILER_OPTIONS

mofcomp