클라이언트가 제어하는 프로필을 나타냅니다. 이 인터페이스는 파일 또는 문자열에서 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 |
지정된 속성을 설정합니다. |
지정된 파일에서 프로필을 로드합니다. |
|
지정된 XML 프로필 정의 문자열에서 프로필을 로드합니다. |
|
두 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] 이 프로필이 검색하도록 설계된 문제를 나타냅니다. |