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 .
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
);
[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.
Exécute uniquement une syntaxe case activée.
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.
Envoie différents messages utiles à la console.
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.
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.
Autorise uniquement la création de classes.
Vous ne pouvez pas combiner cet indicateur avec les autres indicateurs.
Mises à jour la classe, sauf s’il existe des conflits.
Vous pouvez combiner cet indicateur avec WBEM_FLAG_UPDATE_ONLY.
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.
Autorisez uniquement les mises à jour.
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.
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.
Si le paramètre User se présente sous la forme domain <\user>, le paramètre Authority doit être NULL.
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 |