Método IMofCompiler::CompileBuffer (wbemcli.h)

El método IMofCompiler::CompileBuffer compila un búfer que contiene datos MOF binarios o un búfer de texto en formato ASCII. Los archivos MOF binarios contienen datos analizados y deben almacenarse en la base de datos. El método CompileBuffer solo acepta matrices de caracteres de varios bytes (búferes de cadena) que no terminan en NULL.

Sintaxis

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

Parámetros

[in] BuffSize

Tamaño de los datos a los que apunta el parámetro pBuffer .

[in] pBuffer

Puntero a los datos del archivo MOF binario o a un búfer de texto en formato ASCII.

[in] ServerAndNamespace

Nombre del servidor y el espacio de nombres.

Este parámetro se omite a menos que el parámetro pBuffer apunte a un búfer de texto. Si el texto MOF se pasa sin una instrucción #pragma , el archivo MOF se compila en el espacio de nombres predeterminado. Si pBuffer apunta a un archivo MOF binario, el parámetro ServerAndNamespace debe ser NULL.

[in] User

Nombre del usuario que solicita el servicio.

Este parámetro especifica las credenciales para compilar en equipos remotos. Si el valor es NULL, el contexto de usuario es lo que use el proceso actual. Esto siempre se omite al conectarse al equipo local. Para obtener más información, vea la sección Comentarios.

[in] Authority

Especifica las credenciales para compilar en equipos remotos. Si el valor es NULL, el contexto de autoridad es lo que use el proceso actual. Este parámetro siempre se omite al conectarse al equipo local. Para obtener más información, vea la sección Comentarios.

[in] Password

Especifica las credenciales para compilar en equipos remotos. Si el valor es NULL, se usa la contraseña del contexto actual. Este parámetro siempre se omite al conectarse al equipo local.

[in] lOptionFlags

Puede combinar una o varias de las marcas siguientes.

WBEM_FLAG_CHECK_ONLY

Realiza solo una comprobación de sintaxis.

WBEM_FLAG_AUTORECOVER

Si el método se realiza correctamente, agrega el nombre de archivo a la lista de archivos que se compilarán durante la recuperación automática de la base de datos.

Esta marca no se puede combinar con los marcadores de espacio de nombres, clase o instancia.

WBEM_FLAG_CONSOLE_PRINT

Envía varios mensajes útiles a la consola.

WBEM_FLAG_DONT_ADD_TO_LIST

Impide la adición del archivo a la lista de archivos que se van a compilar durante la recuperación automática de la base de datos.

Esta marca no es compatible con WBEM_FLAG_AUTORECOVER.

[in] lClassFlags

Este parámetro se omite porque el archivo MOF binario ya contiene la información. El valor del parámetro debe ser 0.

[in] lInstanceFlags

Se omite porque el archivo MOF binario ya contiene la información. El valor del parámetro debe ser 0.

[in, out] pInfo

Puntero a un WBEM_COMPILE_STATUS_INFO que describe un error.

Si el valor del parámetro no es NULL, se ha producido un error y la estructura se rellena con información de error.

Valor devuelto

Este método devuelve WBEM_S_NO_ERROR si se ejecuta correctamente. Si el método no se realiza correctamente, devuelve WBEM_S_FALSE.

Comentarios

Si el parámetro User adopta el formato <domain\user>, el parámetro Authority debe ser NULL.

El método CreateBMOF puede generar datos MOF binarios, que almacena los datos de MOF binarios en un archivo que se puede leer antes de llamar al método CompileBuffer .

Requisitos

Consulte también

IMofCompiler

WBEM_COMPILER_OPTIONS