Compartir a través de

IProfile

Representa un perfil que controla el cliente. La interfaz proporciona funciones que cargan un perfil, en formato XML, ya sea desde un archivo o desde una cadena. El cliente puede determinar si el usuario puede actualizar al perfil agregando o quitando proveedores de Seguimiento de eventos para Windows (ETW).

Sintaxis

{
  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

En la tabla siguiente se describen las funciones que proporciona esta interfaz.

Función Descripción

propget

Devuelve el valor de la propiedad especificada.

propput

Establece la propiedad especificada.

LoadFromFile

Carga un perfil del archivo especificado.

LoadFromString

Carga un perfil de la cadena de definición de perfil XML especificada.

IsEqual

Compara dos objetos IProfile .

Propiedades

Esta interfaz proporciona las propiedades descritas en la tabla siguiente.

Propiedad Parámetros Descripción

IsMutable

pfMutable

[out] Devuelve un valor booleano que indica que se pueden agregar sesiones y proveedores a un perfil existente cuando los perfiles del mismo nombre se combinan con el método IProfileCollection::Add . S_OK indica que se ha realizado correctamente.

IsMutable

fMutable

[in] Valor booleano que indica si se pueden agregar sesiones y proveedores a los perfiles. S_OK indica que se ha realizado correctamente.

Versión

pVersion

[out] Indica la versión de los perfiles.

Autor

pbstrAuthor

[out] Indica el autor de los perfiles.

Equipo

pbstrTeam

[out] Indica el equipo que creó los perfiles.

Comentarios

pbstrComments

[out] Comentarios opcionales sobre los perfiles.

Company

pbstrCompany

[out] Indica la empresa que creó los perfiles.

Copyright

pbstrCopyright

[out] Indica información de copyright relacionada con los perfiles.

Tag

pbstrTag

[out] Valor etiquetado opcional que se puede usar para diferenciar entre perfiles.

Id

pbstrId

[out] Indica el identificador del perfil.

Nombre

pbstrName

[out] Indica el nombre del perfil.

Descripción

pbstrDescription

[out] Indica la descripción del perfil.

LoggingMode

pLoggingMode

[out] Indica el modo de registro.

LoggingModeString

pbstrLoggingMode

[out] Indica la cadena de modo de registro. Los valores posibles son "memory" y "file".

DetailLevel

pDetailLevel

[out] Indica el nivel de detalle.

DetailLevelString

pbstrDetailLevel

[out] Indica la cadena de nivel de detalle. Los valores posibles son "verbose" y "light".

IsStrict

pfStrict

[out] Valor booleano que indica si la grabación se revierte si algún recopilador o proveedor no se inicia.

IsDefault

pfDefault

[out] Valor booleano que indica si se trata de un perfil predeterminado.

ProblemCategories

pbstrProblemCategories

[out] Indica los problemas que este perfil está diseñado para detectar.

Interfaces

  • Last updated on