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.

Temas relacionados

Interfaces