IProfile

Mewakili profil yang dikontrol klien. Antarmuka menyediakan fungsi yang memuat profil, dalam format XML, baik dari file atau dari string. Klien dapat menentukan apakah pengguna diizinkan untuk memperbarui ke profil dengan menambahkan atau menghapus penyedia Pelacakan Peristiwa untuk Windows (ETW).

Sintaks

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

Fungsi

Tabel berikut menjelaskan fungsi yang disediakan antarmuka ini.

Fungsi	Deskripsi
propget	Mengembalikan nilai properti yang ditentukan.
propput	Mengatur properti yang ditentukan.
LoadFromFile	Memuat profil dari file yang ditentukan.
LoadFromString	Memuat profil dari string definisi profil XML yang ditentukan.
IsEqual	Membandingkan dua objek IProfile .

Properti

Antarmuka ini menyediakan properti yang dijelaskan dalam tabel berikut.

Properti	Parameter	Deskripsi
Dapat Diubah	pfMutable	[keluar] Mengembalikan nilai Boolean yang menunjukkan bahwa sesi dan penyedia dapat ditambahkan ke profil yang ada saat profil dengan nama yang sama dikombinasikan dengan metode IProfileCollection::Add . S_OK menunjukkan keberhasilan.
Dapat Diubah	dapat diubah	[in] Nilai Boolean yang menunjukkan apakah sesi dan penyedia dapat ditambahkan ke profil. S_OK menunjukkan keberhasilan.
Versi	pVersion	[keluar] Menunjukkan versi profil.
Penulis	pbstrAuthor	[keluar] Menunjukkan penulis profil.
Tim	pbstrTeam	[keluar] Menunjukkan tim yang membuat profil.
Komentar	pbstrComments	[keluar] Komentar opsional tentang profil.
Company	pbstrCompany	[keluar] Menunjukkan perusahaan yang membuat profil.
Hak cipta	pbstrCopyright	[keluar] Menunjukkan informasi hak cipta yang terkait dengan profil.
Menandai	pbstrTag	[keluar] Nilai bertag opsional yang dapat digunakan untuk membedakan antara profil.
Id	pbstrId	[keluar] Menunjukkan pengidentifikasi profil.
Nama	pbstrName	[keluar] Menunjukkan nama profil.
Deskripsi	pbstrDescription	[keluar] Menunjukkan deskripsi profil.
LoggingMode	pLoggingMode	[keluar] Menunjukkan mode pengelogan.
LoggingModeString	pbstrLoggingMode	[keluar] Menunjukkan string mode pengelogan. Nilai yang mungkin adalah "memori" dan "file".
DetailLevel	pDetailLevel	[keluar] Menunjukkan tingkat detail.
DetailLevelString	pbstrDetailLevel	[keluar] Menunjukkan string tingkat detail. Nilai yang mungkin adalah "verbose" dan "light".
IsStrict	pfStrict	[keluar] Boolean yang menunjukkan apakah rekaman digulung balik jika ada pengumpul atau penyedia yang gagal memulai.
IsDefault	pfDefault	[keluar] Boolean yang menunjukkan apakah ini adalah profil default.
ProblemCategories	pbstrProblemCategories	[keluar] Menunjukkan masalah yang dirancang untuk dideteksi oleh profil ini.

Topik terkait

Antarmuka