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

Recupera la lista de palabras clave que restringe la categoría de eventos que desea que escriba el proveedor. Las restricciones se agregan a las proporcionadas por la propiedad ITraceDataProvider::KeywordsAny .

Esta propiedad es de solo lectura.

Sintaxis

HRESULT get_KeywordsAll(
  IValueMap **ppKeywords
);

Parámetros

ppKeywords

Valor devuelto

None

Observaciones

El proveedor escribe un evento si alguno de los bits de palabra clave del evento coincide con cualquiera de los bits establecidos en la propiedad KeywordsAny . Las palabras clave especificadas en la propiedad KeywordsAll restringen aún más la categoría de eventos que desea que escriba el proveedor. Si la palabra clave del evento cumple la condición KeywordsAny , el proveedor escribirá el evento solo si todos los bits de la máscara KeywordsAll existen en la palabra clave del evento. La máscara KeywordsAll no se usa si KeywordsAny es cero.

Para obtener más información sobre cómo se relacionan las condiciones KeywordsAll y KeywordsAny , vea la sección Comentarios de KeywordsAny.

Use la interfaz IValueMap 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 bien 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 los 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. Debe usar la interfaz IValueMapItem solo 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::KeywordsAny