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 |