IProfile

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.

Rubriques connexes

Interfaces