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

Article
03/03/2024

La méthode IMofCompiler ::CreateBMOF crée un fichier MOF binaire. La création de fichier s’effectue en analysant un fichier MOF normal et en stockant une représentation binaire des classes et des instances dans un format de fichier spécial. En règle générale, cet objet BLOB (Data Binary Large Object) est stocké en tant que ressource dans un fichier exécutable, qui peut être extrait ultérieurement pour un appel à la méthode CompileBuffer . IMofCompiler ::CreateBMOF peut également être utilisé pour créer un fichier MOF localisé (.mfl).

Syntaxe

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

Paramètres

[in] TextFileName

Nom du fichier texte à analyser.

[in] BMOFFileName

Fichier MOF binaire : Nom du fichier dans lequel les données MOF binaires obtenues doivent être stockées.

Fichier MOF localisé : La chaîne BMOFFileName doit contenir les valeurs séparées par des virgules suivantes :

paramètres<régionaux>
Spécifie les informations de paramètres régionaux. Cette valeur doit commencer par une virgule précédente. Pour plus d’informations, consultez la description du commutateur -ADMENDMENT pour l’utilitaire mofcomp .
n<filename.mof>
Nom du fichier dans lequel les données MOF binaires obtenues doivent être stockées.
l<filename.mfl>
Nom du fichier dans lequel les données MOF localisées obtenues doivent être stockées.

Par exemple, BMOFFileName= »,aMS_409,nmyFile.mof,lmyFile.mfl ».

[in] ServerAndNamespace

Chemin d’accès de l’espace de noms par défaut, où les classes ou instances sont écrites.

Vous pouvez utiliser ce paramètre pour spécifier un espace de noms sur un ordinateur distant (« \computer\root », par exemple). Cette valeur peut être remplacée par la commande #pragma et ne doit pas être utilisée si vous utilisez la récupération automatique. Si la valeur du paramètre est NULL, l’espace de noms root\default sur l’ordinateur local est la valeur par défaut.

[in] lOptionFlags

Vous pouvez combiner un ou plusieurs des indicateurs suivants.

WBEM_FLAG_CHECK_ONLY

Exécute uniquement une syntaxe case activée.

WBEM_FLAT_CONSOLE_PRINT

Envoie différents messages utiles à la console.

WBEM_FLAG_WMI_CHECK

Effectue des vérifications supplémentaires sur le fichier MOF binaire résultant à l’aide du programme WMIMOFCHK, qui fait partie de la section WMI du SDK Windows.

[in] lClassFlags

Indicateurs qui contrôlent la création de classes. La valeur du paramètre peut être 0 ou une combinaison des indicateurs suivants.

WBEM_FLAG_UPDATE_ONLY

Empêche la création de classes.

Vous pouvez combiner cet indicateur avec WBEM_FLAG_UPDATE_SAFE_MODE ou WBEM_FLAG_UPDATE_FORCE_MODE.

WBEM_FLAG_CREATE_ONLY

Autorise uniquement la création de classes.

Vous ne pouvez pas combiner cela avec d’autres indicateurs.

WBEM_FLAG_UPDATE_SAFE_MODE

Mises à jour la classe, sauf s’il existe des conflits.

Vous pouvez combiner cet indicateur avec WBEM_FLAG_UPDATE_ONLY.

WBEM_FLAG_UPDATE_FORCE_MODE

Mises à jour et résout les conflits lorsque cela est possible. L’utilisation du mode force pour mettre à jour une classe statique entraîne la suppression de toutes les instances de cette classe. Forcer une mise à jour pour une classe de fournisseur ne supprime pas les instances de la classe .

Vous pouvez combiner cet indicateur avec lInstanceFlags.

[in] lInstanceFlags

Indicateurs contrôlant la création d’instances.

La valeur du paramètre peut être 0 ou l’un des indicateurs suivants.

WBEM_FLAG_UPDATE_ONLY

Autorise uniquement les mises à jour.

WBEM_FLAG_CREATE_ONLY

Autorise uniquement les nouvelles instances.

[in, out] pInfo

Pointeur vers un WBEM_COMPILE_STATUS_INFO qui décrit une erreur.

Si la valeur du paramètre n’est pas NULL, une erreur s’est produite et la structure est remplie d’informations d’erreur.

Valeur retournée

Cette méthode retourne WBEM_S_NO_ERROR si elle réussit. Si la méthode échoue, elle retourne WBEM_S_FALSE.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	wbemcli.h (inclure Wbemidl.h)
Bibliothèque	Wbemuuid.lib
DLL	Mofd.dll