Compartir a través de


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

El método IMofCompiler::CompileFile compila un archivo MOF (incluidos los MOF binarios) y almacena la información en el repositorio WMI. Este método realiza la misma operación que el comando Mofcomp .

Sintaxis

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

Parámetros

[in] FileName

Nombre del archivo que se va a compilar.

[in] ServerAndNamespace

Ruta de acceso al espacio de nombres predeterminado donde se escriben las clases o instancias.

Puede especificar un espacio de nombres en un equipo remoto ("\equipo\raíz", por ejemplo). El comando #pragma puede invalidar este valor y no debe usarse si se desea la recuperación automática. Si es NULL, el espacio de nombres root\default en el equipo local es el valor predeterminado.

[in] User

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

[in] Authority

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

[in] Password

Valor que especifica las credenciales para compilar en equipos remotos. Si el valor es NULL, se usa la contraseña del contexto actual. Esto siempre se omite al conectarse al equipo local.

[in] lOptionFlags

Parámetro que, cuando se usa el método CompileFile , habilita la combinación de 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 del archivo a la lista de archivos que se compilarán durante la recuperación automática de la base de datos.

Tenga en cuenta que 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 que el archivo se agregue a la lista de archivos compilados durante la recuperación automática de la base de datos.

Esta marca no es compatible con WBEM_FLAG_AUTORECOVER.

[in] lClassFlags

Marcas que controlan la creación de clases.

Los parámetros pueden ser 0 o una combinación de los valores siguientes.

WBEM_FLAG_UPDATE_ONLY

Impide la creación de una clase.

Puede combinar esta marca con WBEM_FLAG_UPDATE_SAFE_MODE o WBEM_FLAG_UPDATE_FORCE_MODE.

WBEM_FLAG_CREATE_ONLY

Solo permite la creación de clases.

Es posible que no combine esta marca con las otras marcas.

WBEM_FLAG_UPDATE_SAFE_MODE

Novedades la clase a menos que existan conflictos.

Puede combinar esta marca con WBEM_FLAG_UPDATE_ONLY.

WBEM_FLAG_UPDATE_FORCE_MODE

Novedades y resuelve los conflictos siempre que sea posible. El uso del modo force para actualizar una clase estática da como resultado la eliminación de todas las instancias de esa clase. Forzar la actualización en una clase de proveedor no elimina instancias de la clase .

Puede combinar esta marca con llnstanceFlags.

[in] lInstanceFlags

Marcas que controlan la creación de instancias.

Los valores de parámetro pueden ser 0 o una de las marcas siguientes.

WBEM_FLAG_UPDATE_ONLY

Permitir solo las actualizaciones.

WBEM_FLAG_CREATE_ONLY

Permitir solo nuevas instancias.

[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 puede devolver uno de estos valores.

2

Advertencia de que #pragma instrucción de autorrecuperación no está presente. Esta instrucción debe ser una de las primeras líneas del archivo MOF.

Comentarios

Si el parámetro User está en forma de <dominio\usuario>, el parámetro Authority debe ser NULL.

Requisitos

   
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2008
Plataforma de destino Windows
Encabezado wbemcli.h (include Wbemidl.h)
Library Wbemuuid.lib
Archivo DLL Mofd.dll

Consulte también

IMofCompiler

WBEM_CHANGE_FLAG_TYPE

WBEM_COMPILER_OPTIONS

mofcomp