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

Artículo
08/27/2023

El método IMofCompiler::CreateBMOF crea un archivo MOF binario. La creación de archivos se realiza mediante el análisis de un archivo MOF normal y el almacenamiento de una representación binaria de las clases e instancias en un formato de archivo especial. Normalmente, este objeto binario de datos grande (BLOB) se almacena como un recurso en un archivo ejecutable, que posteriormente se puede extraer para una llamada al método CompileBuffer . El IMofCompiler::CreateBMOF también se puede usar para crear un archivo MOF localizado (.mfl).

Sintaxis

HRESULT CreateBMOF(
  [in]      LPWSTR                   TextFileName,
  [in]      LPWSTR                   BMOFFileName,
  [in]      LPWSTR                   ServerAndNamespace,
  [in]      LONG                     lOptionFlags,
  [in]      LONG                     lClassFlags,
  [in]      LONG                     lInstanceFlags,
  [in, out] WBEM_COMPILE_STATUS_INFO *pInfo
);

Parámetros

[in] TextFileName

Nombre del archivo de texto que se va a analizar.

[in] BMOFFileName

Archivo MOF binario: Nombre del archivo en el que se almacenarán los datos MOF binarios resultantes.

Archivo MOF localizado: La cadena BMOFFileName debe contener los siguientes valores separados por comas:

una<configuración regional>
Especifica la información de configuración regional. Este valor debe comenzar con una coma anterior. Para obtener más información, vea la descripción del modificador -ADMENDMENT para la utilidad mofcomp .
n<filename.mof>
Nombre del archivo en el que se almacenarán los datos MOF binarios resultantes.
l<filename.mfl>
Nombre del archivo en el que se almacenarán los datos MOF localizados resultantes.

Por ejemplo, BMOFFileName=",aMS_409,nmyFile.mof,lmyFile.mfl".

[in] ServerAndNamespace

Ruta de acceso del espacio de nombres predeterminado, donde se escriben clases o instancias.

Puede usar este parámetro para 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 usa autorecovery. Si el valor del parámetro es NULL, el espacio de nombres root\default en el equipo local es el valor predeterminado.

[in] lOptionFlags

Puede combinar una o varias de las marcas siguientes.

WBEM_FLAG_CHECK_ONLY

Realiza solo una comprobación de sintaxis.

WBEM_FLAT_CONSOLE_PRINT

Envía varios mensajes útiles a la consola.

WBEM_FLAG_WMI_CHECK

Realiza comprobaciones adicionales en el archivo MOF binario resultante mediante el programa WMIMOFCHK, que forma parte de la sección WMI del Windows SDK.

[in] lClassFlags

Marcas que controlan la creación de clases. El valor del parámetro puede ser 0 o una combinación de las marcas siguientes.

WBEM_FLAG_UPDATE_ONLY

Impide la creación de clases.

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.

No se puede combinar con 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 conflictos cuando 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. Fuerza una actualización de una clase de proveedor no elimina instancias de la clase .

Puede combinar esta marca con lInstanceFlags.

[in] lInstanceFlags

Marcas que controlan la creación de instancias.

El valor del parámetro puede ser 0 o uno de los siguientes marcadores.

WBEM_FLAG_UPDATE_ONLY

Solo permite actualizaciones.

WBEM_FLAG_CREATE_ONLY

Solo permite 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 devuelve WBEM_S_NO_ERROR si se ejecuta correctamente. Si el método no se realiza correctamente, devuelve WBEM_S_FALSE.

Requisitos

Requisito	Value
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