IProfile

Stellt ein Profil dar, das der Client steuert. Die Schnittstelle stellt Funktionen bereit, die ein Profil entweder aus einer Datei oder aus einer Zeichenfolge laden. Der Client kann bestimmen, ob der Benutzer das Profil aktualisieren darf, indem er Ereignisablaufverfolgungsanbieter für Windows (ETW) hinzufügt oder entfernt.

Syntax

{
  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);};

Functions

In der folgenden Tabelle werden die Funktionen beschrieben, die diese Schnittstelle bereitstellt.

Funktion	Beschreibung
propget	Gibt den Wert der angegebenen Eigenschaft zurück.
propput	Legt die angegebene Eigenschaft fest.
LoadFromFile	Lädt ein Profil aus der angegebenen Datei.
LoadFromString	Lädt ein Profil aus der angegebenen XML-Profildefinitionszeichenfolge.
IsEqual	Vergleicht zwei IProfile-Objekte.

Eigenschaften

Diese Schnittstelle bietet die in der folgenden Tabelle beschriebenen Eigenschaften.

Eigenschaft	Parameter	Beschreibung
IsMutable	pfMutable	[out] Gibt einen booleschen Wert zurück, der angibt, dass Sitzungen und Anbieter einem vorhandenen Profil hinzugefügt werden können, wenn Profile desselben Namens mit der IProfileCollection::Add-Methode kombiniert werden. S_OK zeigt die erfolgreiche Ausführung an.
IsMutable	fMutable	[in] Ein boolescher Wert, der angibt, ob Sitzungen und Anbieter den Profilen hinzugefügt werden können. S_OK zeigt die erfolgreiche Ausführung an.
Version	pVersion	[out] Gibt die Version des Profils an.
Autor	pbstrAuthor	[out] Gibt den Autor des Profils an.
Team	pbstrTeam	[out] Gibt das Team an, das die Profile erstellt hat.
Kommentare	pbstrComments	[out] Optionale Kommentare zu den Profilen.
Company	pbstrCompany	[out] Gibt das Unternehmen an, das die Profile erstellt hat.
Copyright	pbstrCopyright	[out] Gibt Copyrightinformationen im Zusammenhang mit den Profilen an.
Tag	pbstrTag	[out] Optionaler markierter Wert, der verwendet werden kann, um zwischen Profilen zu unterscheiden.
Id	pbstrId	[out] Gibt den Bezeichner des Profils an.
Name	pbstrName	[out] Gibt den Namen des Profils an.
Beschreibung	pbstrDescription	[out] Gibt die Beschreibung des Profils an.
LoggingMode	pLoggingMode	[out] Gibt den Protokollierungsmodus an.
LoggingModeString	pbstrLoggingMode	[out] Gibt die Zeichenfolge für den Protokollierungsmodus an. Mögliche Werte sind "Memory" und "file".
DetailLevel	pDetailLevel	[out] Gibt die Detailebene an.
DetailLevelString	pbstrDetailLevel	[out] Gibt die Zeichenkette der Detailebene an. Mögliche Werte sind "verbose" und "light".
IsStrict	pfStrict	[out] Ein boolescher Wert, der angibt, ob die Aufzeichnung zurückgesetzt wird, wenn ein Sammler oder Anbieter nicht gestartet werden kann.
IsDefault	pfDefault	[out] Ein boolescher Wert, der angibt, ob es sich um ein Standardprofil handelt.
ProblemCategories	pbstrProblemCategories	[out] Gibt die Probleme an, die dieses Profil erkennen soll.

Zugehörige Themen

Schnittstellen