Método ITraceDataProvider::get_KeywordsAny (pla.h)

Recupera la lista de palabras clave que determinan la categoría de eventos que desea que escriba el proveedor.

Esta propiedad es de solo lectura.

Sintaxis

HRESULT get_KeywordsAny(
  IValueMap **ppKeywords
);

Parámetros

ppKeywords

Valor devuelto

None

Observaciones

Las palabras clave determinan la categoría de eventos que desea que escriba el proveedor. El proveedor escribe un evento si alguno de los bits de palabra clave del evento coincide con cualquiera de los bits establecidos en esta máscara KeywordsAny .

Para incluir todos los eventos que proporciona un proveedor, establezca esta propiedad en cero. Para incluir solo eventos específicos, establezca esta máscara de palabra clave en esos eventos específicos. Por ejemplo, si el proveedor define un evento para sus rutinas de inicialización y limpieza (bit 0), un evento para sus operaciones de archivo (bit 1) y un evento para sus operaciones de cálculo (bit 2), puede elegir incluir solo dos de estos eventos estableciendo esta máscara en 5 (establecer bits 0 y 2) para recibir eventos de inicialización y limpieza y eventos de cálculo.

Para restringir aún más la categoría de eventos que desea que escriba el proveedor, establezca también la propiedad ITraceDataProvider::KeywordsAll .

Si el proveedor define palabras clave de evento más complejas (por ejemplo, el proveedor define un evento que establece el bit 0 para lectura y bit 1 para el acceso local y un segundo evento que establece el bit 0 para lectura y bit 2 para el acceso remoto), puede establecer esta máscara en 1 para recibir todos los eventos de lectura, o bien podría establecer esta máscara en 1 y la máscara KeywordsAll en 3 para recibir solo lecturas locales.

Si la palabra clave de un evento es cero, el proveedor escribirá el evento en la sesión, independientemente de esta máscara o la máscara KeywordsAll .

En el caso de los proveedores escritos en un sistema operativo antes de Windows Vista, el valor de palabra clave se asignará a las marcas enable.

La interfaz IValueMap se usa para recuperar o establecer el valor de las palabras clave. Puede usar la propiedad IValueMap::Value para recuperar el valor de palabras clave (el valor de todos los elementos del mapa cuando se combina con el operador OR ), o puede enumerar cada elemento del mapa para recuperar los valores de palabra clave individuales.

Del mismo modo, al establecer el valor de palabras clave, se llama a la propiedad IValueMap::Value para establecer el valor de palabras clave, o puede llamar al método IValueMap::Add para agregar cada valor de palabra clave individual.

Si usa IValueMap::Value para establecer las palabras clave y el mapa de valores contiene uno o varios elementos, PLA busca valores coincidentes y los habilita y deshabilita. Si el valor no existe en la lista, PLA agrega la palabra clave (el elemento no tiene nombre).

La propiedad IValueMapItem::Key contiene la representación de cadena de la palabra clave. La propiedad IValueMapItem::Value contiene el valor de palabra clave. La propiedad IValueMapItem::Enabled indica si la palabra clave está habilitada. Solo debe usar la interfaz IValueMapItem cuando quiera asignar un nombre a la palabra clave o desea habilitar o deshabilitar palabras clave sin tener que agregarlas ni quitarlas.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	pla.h
Archivo DLL	Pla.dll

Consulte también

ITraceDataProvider

ITraceDataProvider::KeywordsAll