IProfile

클라이언트가 제어하는 프로필을 나타냅니다. 이 인터페이스는 파일 또는 문자열에서 XML 형식으로 프로필을 로드하는 함수를 제공합니다. 클라이언트는 ETW(Windows용 이벤트 추적) 공급자를 추가하거나 제거하여 사용자가 프로필을 업데이트할 수 있는지 여부를 결정할 수 있습니다.

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

다음 표에서는 이 인터페이스가 제공하는 함수에 대해 설명합니다.

함수	설명
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] 프로필과 관련된 저작권 정보를 나타냅니다.
Tag	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] 이 프로필이 검색하도록 설계된 문제를 나타냅니다.

관련 항목

인터페이스