Метод IMofCompiler::CompileBuffer (wbemcli.h)

Статья
03/03/2024

Метод IMofCompiler::CompileBuffer компилирует либо буфер, содержащий двоичные MOF-данные, либо текстовый буфер в формате ASCII. Двоичные MOF-файлы содержат проанализированные данные и должны храниться в базе данных. Метод CompileBuffer принимает только многобайтовые массивы символов (строковые буферы), которые не заканчиваются null.

Синтаксис

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

Параметры

[in] BuffSize

Размер данных, на которые указывает параметр pBuffer .

[in] pBuffer

Указатель на данные двоичного MOF-файла или текстовый буфер в формате ASCII.

[in] ServerAndNamespace

Имя сервера и пространство имен.

Этот параметр игнорируется, если только параметр pBuffer не указывает на текстовый буфер. Если MOF-файл текста передается без оператора #pragma , то MOF-файл компилируется в пространство имен по умолчанию. Если pBuffer указывает на двоичный MOF-файл, параметр ServerAndNamespace должен иметь значение NULL.

[in] User

Имя пользователя, запрашивающего службу.

Этот параметр задает учетные данные для компиляции на удаленных компьютерах. Если значение равно NULL, то контекст пользователя — это то, что использует текущий процесс. Это всегда игнорируется при подключении к локальному компьютеру. Дополнительные сведения см. в разделе «Примечания».

[in] Authority

Указывает учетные данные для компиляции на удаленных компьютерах. Если значение равно NULL, то контекстом центра является то, что использует текущий процесс. Этот параметр всегда игнорируется при подключении к локальному компьютеру. Дополнительные сведения см. в разделе «Примечания».

[in] Password

Указывает учетные данные для компиляции на удаленных компьютерах. Если значение равно NULL, используется пароль текущего контекста. Этот параметр всегда игнорируется при подключении к локальному компьютеру.

[in] lOptionFlags

Вы можете объединить один или несколько следующих флагов.

WBEM_FLAG_CHECK_ONLY

Выполняет только синтаксическую проверка.

WBEM_FLAG_AUTORECOVER

Если метод выполнен успешно, он добавляет имя файла в список файлов, которые будут компилироваться во время автоматического восстановления базы данных.

Этот флаг не может быть объединён с флагами пространства имен, класса или экземпляра.

WBEM_FLAG_CONSOLE_PRINT

Отправляет различные полезные сообщения в консоль.

WBEM_FLAG_DONT_ADD_TO_LIST

Предотвращает добавление файла в список скомпилированных файлов во время автоматического восстановления базы данных.

Этот флаг несовместим с WBEM_FLAG_AUTORECOVER.

[in] lClassFlags

Этот параметр игнорируется, так как двоичный MOF-файл уже содержит сведения. Значение параметра должно быть равно 0.

[in] lInstanceFlags

Игнорируется, так как двоичный MOF-файл уже содержит сведения. Значение параметра должно быть равно 0.

[in, out] pInfo

Указатель на WBEM_COMPILE_STATUS_INFO , описывающий ошибку.

Если значение параметра не равно NULL, произошла ошибка и структура заполняется сведениями об ошибке.

Возвращаемое значение

Этот метод возвращает WBEM_S_NO_ERROR в случае успешного выполнения. Если метод завершается неудачно, он возвращает WBEM_S_FALSE.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	wbemcli.h (включая Wbemidl.h)
Библиотека	Wbemuuid.lib
DLL	Mofd.dll

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

IMofCompiler

WBEM_COMPILER_OPTIONS

Поделиться через