IProfile

表示用戶端所控制的設定檔。 介面提供函式，以 XML 格式從檔案或字串載入設定檔。 用戶端可以藉由新增或移除 Windows (ETW) 提供者的事件追蹤，來判斷是否允許使用者更新至設定檔。

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

函式

下表描述這個介面所提供的函式。

函式	描述
propget	傳回指定之屬性的值。
propput	設定指定的屬性。
LoadFromFile	從指定的檔案載入設定檔。
LoadFromString	從指定的 XML 設定檔定義字串載入設定檔。
IsEqual	比較兩個 IProfile 物件。

屬性

此介面提供下表所述的屬性。

屬性	參數	描述
IsMutable	pfMutable	[out]傳回布林值，指出當相同名稱的設定檔與 IProfileCollection：：Add 方法結合時，可以將會話和提供者新增至現有的設定檔。 S_OK表示成功。
IsMutable	fMutable	[in]布林值，指出會話和提供者是否可以新增至設定檔。 S_OK表示成功。
版本	pVersion	[out]指出設定檔的版本。
Author (作者)	pbstrAuthor	[out]指出設定檔的作者。
球隊	pbstrTeam	[out]指出建立設定檔的小組。
註解	pbstrComments	[out]關於設定檔的選擇性批註。
公司	pbstrCompany	[out]指出建立設定檔的公司。
Copyright (著作權)	pbstrCopyright	[out]指出與設定檔相關的著作權資訊。
標籤	pbstrTag	[out]可用來區分設定檔的選擇性標記值。
Id	pbstrId	[out]指出設定檔的識別碼。
名稱	pbstrName	[out]指出設定檔的名稱。
說明	pbstrDescription	[out]指出設定檔的描述。
LoggingMode	pLoggingMode	[out]表示記錄模式。
LoggingModeString	pbstrLoggingMode	[out]表示記錄模式字串。 可能的值為 「memory」 和 「file」。
DetailLevel	pDetailLevel	[out]表示詳細資料層級。
DetailLevelString	pbstrDetailLevel	[out]表示詳細資料層級字串。 可能的值為 「verbose」 和 「light」。
IsStrict	pfStrict	[out]布林值，指出錄製是否會在任何收集器或提供者無法啟動時回復。
IsDefault	pfDefault	[out]布林值，指出這是否為預設設定檔。
ProblemCategories	pbstrProblemCategories	[out]指出此設定檔的設計目的是要偵測的問題。

相關主題

介面