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

  • Article

La méthode IMofCompiler::CompileFile compile un fichier MOF (y compris les fichiers MOF binaires) et stocke les informations dans le référentiel WMI. Cette méthode effectue la même opération que la commande Mofcomp .

Syntaxe

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

Paramètres

[in] FileName

Nom du fichier à compiler.

[in] ServerAndNamespace

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

Vous pouvez 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 la récupération automatique est souhaitée. Si la valeur est NULL, l’espace de noms root\default sur l’ordinateur local est la valeur par défaut.

[in] User

Valeur qui spécifie les informations d’identification utilisées pour la compilation sur les ordinateurs distants. Si la valeur est NULL, le contexte utilisateur correspond à ce que le processus appelant utilise. Cela est toujours ignoré lors de la connexion à l’ordinateur local. Pour plus d'informations, consultez la section Notes.

[in] Authority

Valeur qui spécifie les informations d’identification pour la compilation sur des ordinateurs distants. Si la valeur est NULL, le contexte d’autorité correspond à ce que le processus appelant utilise. Cela est toujours ignoré lors de la connexion à l’ordinateur local. Pour plus d'informations, consultez la section Notes.

[in] Password

Valeur qui spécifie les informations d’identification pour la compilation sur des ordinateurs distants. Si la valeur est NULL, le mot de passe du contexte actuel est utilisé. Cela est toujours ignoré lors de la connexion à l’ordinateur local.

[in] lOptionFlags

Paramètre qui, lorsque la méthode CompileFile est utilisée, active la combinaison d’un ou plusieurs des indicateurs suivants.

WBEM_FLAG_CHECK_ONLY

Exécute uniquement une syntaxe case activée.

WBEM_FLAG_AUTORECOVER

Si la méthode réussit, ajoute le nom du fichier à la liste des fichiers à compiler lors de la récupération automatique de la base de données.

N’oubliez pas que cet indicateur ne peut pas être combiné avec l’espace de noms, la classe ou les indicateurs instance.

WBEM_FLAG_CONSOLE_PRINT

Envoie différents messages utiles à la console.

WBEM_FLAG_DONT_ADD_TO_LIST

Empêche l’ajout du fichier à la liste des fichiers compilés lors de la récupération automatique de la base de données.

Cet indicateur n’est pas compatible avec WBEM_FLAG_AUTORECOVER.

[in] lClassFlags

Indicateurs qui contrôlent la création de classes.

Les paramètres peuvent être 0 ou une combinaison des valeurs suivantes.

WBEM_FLAG_UPDATE_ONLY

Empêche la création d’une classe.

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 cet indicateur avec les 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 dans la mesure du possible. L’utilisation du mode force pour mettre à jour une classe statique entraîne la suppression de toutes les instances de cette classe. Forcer la mise à jour sur une classe de fournisseur ne supprime pas les instances de la classe .

Vous pouvez combiner cet indicateur avec llnstanceFlags.

[in] lInstanceFlags

Indicateurs qui contrôlent la création d’instances.

Les valeurs de paramètre peuvent être 0 ou l’un des indicateurs suivants.

WBEM_FLAG_UPDATE_ONLY

Autorisez uniquement les mises à jour.

WBEM_FLAG_CREATE_ONLY

Autorisez 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 peut retourner l’une de ces valeurs.

2

Avertissement indiquant que #pragma’instruction de récupération automatique n’est pas présente. Cette instruction doit être l’une des premières lignes du fichier MOF.

Remarques

Si le paramètre User se présente sous la forme domain <\user>, le paramètre Authority doit être NULL.

Configuration requise

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

Voir aussi

IMofCompiler

WBEM_CHANGE_FLAG_TYPE

WBEM_COMPILER_OPTIONS

mofcomp