Compartir a través de

Función PerfSetULongLongCounterValue (perflib.h)

  • Artículo

Novedades el valor de un contador cuyo valor es un entero de 8 bytes sin signo. Los proveedores usan esta función.

Sintaxis

ULONG PerfSetULongLongCounterValue(
  [in] HANDLE                    Provider,
  [in] PPERF_COUNTERSET_INSTANCE Instance,
  [in] ULONG                     CounterId,
  [in] ULONGLONG                 Value
);

Parámetros

[in] Provider

Identificador del proveedor. Use la variable handle que la herramienta CTRPP generó automáticamente. Para el nombre de la variable, vea el atributo symbol del elemento provider .

Windows Vista: La función PerfStartProvider devuelve el identificador.

[in] Instance

Estructura PERF_COUNTERSET_INSTANCE que contiene la instancia del conjunto de contadores. La función PerfCreateInstance devuelve este puntero.

[in] CounterId

Identificador que identifica de forma única el contador que se va a actualizar en el bloque de instancia. El identificador se define en el atributo id del elemento counter y debe coincidir con el miembro CounterId de una de las estructuras de PERF_COUNTER_INFO del bloque de instancia. Use la constante de id. de contador que la herramienta CTRPP generó automáticamente. Para el nombre de la constante, vea el atributo symbol del elemento counter .

Windows Vista: La constante id. de contador no está disponible.

[in] Value

Nuevo valor de contador de 8 bytes.

Valor devuelto

Si la función se realiza correctamente, devuelve ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto es un código de error del sistema.

Comentarios

Se trata de una función útil para establecer datos de contadores sin procesar. Para actualizar los datos de contadores sin procesar, use el miembro Offset de la estructura de PERF_COUNTER_INFO para acceder a los datos de contador sin procesar de un contador específico. El bloque de estructura PERF_COUNTERSET_INSTANCE contiene una o varias estructuras de información de contadores.

Puede usar las funciones PerfIncrementULongLongCounterValue y PerfDecrementULongLongCounterValue para incrementar o disminuir el valor del contador, respectivamente.

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 perflib.h
Library Advapi32.lib
Archivo DLL Advapi32.dll

Consulte también

PerfDecrementULongLongCounterValue

PerfIncrementULongLongCounterValue

PerfSetCounterRefValue

PerfSetULongCounterValue