Méthode IMofCompiler::CompileFile (wbemcli.h)
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 |