Partager via

IProfile

  • Article

Représente un profil que le client contrôle. L’interface fournit des fonctions qui chargent un profil, au format XML, à partir d’un fichier ou d’une chaîne. Le client peut déterminer si l’utilisateur est autorisé à effectuer une mise à jour vers le profil en ajoutant ou en supprimant des fournisseurs de suivi d’événements pour Windows (ETW).

Syntaxe

{
  typedef enum
  {
    LoggingMode_Unknown,
    LoggingMode_Memory,
    LoggingMode_File,
  }
  CLoggingMode;
  typedef enum
  {
    DetailLevel_Unknown,
    DetailLevel_Light,
    DetailLevel_Verbose,
  }
  CDetailLevel;
  [propget, id(1), helpstring("IsMutable")] HRESULT IsMutable
    ([out, retval] VARIANT_BOOL* pfMutable);
  [propput, id(1), helpstring("IsMutable")] HRESULT IsMutable
    ([in] VARIANT_BOOL fMutable);  [propget, id(2), helpstring("Version")] HRESULT Version
    ([out, retval] float* pVersion);
  [propget, id(3), helpstring("Author")] HRESULT Author
    ([out, retval] BSTR* pbstrAuthor);
  [propget, id(4), helpstring("Team")] HRESULT Team
    ([out, retval] BSTR* pbstrTeam);
  [propget, id(5), helpstring("Comments")] HRESULT Comments
    ([out, retval] BSTR* pbstrComments);
  [propget, id(6), helpstring("Company")] HRESULT Company
    ([out, retval] BSTR* pbstrCompany);
  [propget, id(7), helpstring("Copyright")] HRESULT Copyright
    ([out, retval] BSTR* pbstrCopyright);
  [propget, id(8), helpstring("Tag")] HRESULT Tag
    ([out, retval] BSTR* pbstrTag);
  [propget, id(9), helpstring("Id")] HRESULT Id
    ([out, retval] BSTR* pbstrId);
  [propget, id(10), helpstring("Name")] HRESULT Name
    ([out, retval] BSTR* pbstrName);
  [propget, id(11), helpstring("Description")] HRESULT Description
    ([out, retval] BSTR* pbstrDescription);
  [propget, id(12), helpstring("LoggingMode")] HRESULT LoggingMode
    ([out, retval] CLoggingMode* pLoggingMode);
  [propget, id(13), helpstring("LoggingModeString")] HRESULT LoggingModeString
    ([out, retval] BSTR* pbstrLoggingMode);
  [propget, id(14), helpstring("DetailLevel")] HRESULT DetailLevel
    ([out, retval] CDetailLevel* pDetailLevel);
  [propget, id(15), helpstring("DetailLevelString")] HRESULT DetailLevelString
    ([out, retval] BSTR* pbstrDetailLevel);
  [propget, id(16), helpstring("IsStrict")] HRESULT IsStrict
    ([out, retval] VARIANT_BOOL* pfStrict);
  [propget, id(17), helpstring("IsDefault")] HRESULT IsDefault
    ([out, retval] VARIANT_BOOL* pfDefault);
  [propget, id(18), helpstring("ProblemCategories")] HRESULT ProblemCategories
    ([out, retval] BSTR* pbstrProblemCategories);
  [id(19), helpstring("LoadFromFile")] HRESULT LoadFromFile
    ([in] BSTR bstrProfileName,
    [in] BSTR bstrFileName);
  [id(20), helpstring("LoadFromString")] HRESULT LoadFromString
    ([in] BSTR bstrProfile);
  [id(21), helpstring("IsEqual")] HRESULT IsEqual
    ([in] IProfile* pProfile);};

Fonctions

Le tableau suivant décrit les fonctions que cette interface fournit.

Fonction Description

propget

Retourne la valeur de la propriété spécifiée.

propput

Définit la propriété spécifiée.

LoadFromFile

Charge un profil à partir du fichier spécifié.

LoadFromString

Charge un profil à partir de la chaîne de définition de profil XML spécifiée.

IsEqual

Compare deux objets IProfile .

Propriétés

Cette interface fournit les propriétés décrites dans le tableau suivant.

Propriété Paramètres Description

IsMutable

pfMutable

[out] Retourne une valeur booléenne qui indique que des sessions et des fournisseurs peuvent être ajoutés à un profil existant lorsque des profils du même nom sont combinés avec la méthode IProfileCollection::Add . S_OK indique la réussite.

IsMutable

fMutable

[in] Valeur booléenne qui indique si des sessions et des fournisseurs peuvent être ajoutés aux profils. S_OK indique la réussite.

Version

pVersion

[out] Indique la version des profils.

Auteur

pbstrAuthor

[out] Indique l’auteur des profils.

Team

pbstrTeam

[out] Indique l’équipe qui a créé les profils.

Commentaires

pbstrComments

[out] Commentaires facultatifs sur les profils.

Société

pbstrCompany

[out] Indique l’entreprise qui a créé les profils.

Copyright

pbstrCopyright

[out] Indique les informations de copyright relatives aux profils.

Tag

pbstrTag

[out] Valeur étiquetée facultative qui peut être utilisée pour différencier les profils.

Id

pbstrId

[out] Indique l’identificateur du profil.

Nom

pbstrName

[out] Indique le nom du profil.

Description

pbstrDescription

[out] Indique la description du profil.

LoggingMode

pLoggingMode

[out] Indique le mode de journalisation.

LoggingModeString

pbstrLoggingMode

[out] Indique la chaîne du mode de journalisation. Les valeurs possibles sont « memory » et « file ».

DetailLevel

pDetailLevel

[out] Indique le niveau de détail.

DetailLevelString

pbstrDetailLevel

[out] Indique la chaîne de niveau de détail. Les valeurs possibles sont « verbose » et « light ».

IsStrict

pfStrict

[out] Valeur booléenne qui indique si l’enregistrement est rétabli en cas d’échec du démarrage d’un collecteur ou d’un fournisseur.

IsDefault

pfDefault

[out] Boolean qui indique s’il s’agit d’un profil par défaut.

ProblemCategories

pbstrProblemCategories

[out] Indique les problèmes que ce profil est conçu pour détecter.

Interfaces