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

  • Article

La méthode IMofCompiler ::CompileBuffer compile une mémoire tampon contenant des données MOF binaires ou une mémoire tampon de texte au format ASCII. Les fichiers MOF binaires contiennent des données analysées et doivent être stockés dans la base de données. La méthode CompileBuffer accepte uniquement les tableaux de caractères multioctets (mémoires tampons de chaîne) qui ne sont pas terminés par null.

Syntaxe

HRESULT CompileBuffer(
  [in]      long                     BuffSize,
  [in]      BYTE                     *pBuffer,
  [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] BuffSize

Taille des données pointées par le paramètre pBuffer .

[in] pBuffer

Pointeur vers les données de fichier MOF binaires ou une mémoire tampon de texte au format ASCII.

[in] ServerAndNamespace

Nom du serveur et de l’espace de noms.

Ce paramètre est ignoré, sauf si le paramètre pBuffer pointe vers une mémoire tampon de texte. Si le texte MOF est passé sans instruction #pragma , le fichier MOF est compilé dans l’espace de noms par défaut. Si pBuffer pointe vers un fichier MOF binaire, le paramètre ServerAndNamespace doit être NULL.

[in] User

Nom de l’utilisateur qui demande le service.

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

[in] Authority

Spécifie les informations d’identification pour la compilation sur les ordinateurs distants. Si la valeur est NULL, le contexte d’autorité correspond à ce que le processus actuel utilise. Ce paramètre est toujours ignoré lors de la connexion à l’ordinateur local. Pour plus d'informations, consultez la section Notes.

[in] Password

Spécifie les informations d’identification pour la compilation sur les ordinateurs distants. Si la valeur est NULL, le mot de passe du contexte actuel est utilisé. Ce paramètre est toujours ignoré lors de la connexion à l’ordinateur local.

[in] lOptionFlags

Vous pouvez combiner 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, elle ajoute le nom de fichier à la liste des fichiers à compiler lors de la récupération automatique de la base de données.

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 à compiler 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

Ce paramètre est ignoré, car le fichier MOF binaire contient déjà les informations. La valeur du paramètre doit être 0.

[in] lInstanceFlags

Ignoré, car le fichier MOF binaire contient déjà les informations. La valeur du paramètre doit être 0.

[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.

Remarques

Si le paramètre User prend la forme <domain\user>, le paramètre Authority doit être NULL.

Les données MOF binaires peuvent être générées par la méthode CreateBMOF , qui stocke les données MOF binaires dans un fichier qui peut être lu avant d’appeler la méthode CompileBuffer .

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 (include Wbemidl.h)
Bibliothèque Wbemuuid.lib
DLL Mofd.dll

Voir aussi

IMofCompiler

WBEM_COMPILER_OPTIONS