Função PerfSetULongCounterValue (perflib.h)

Atualizações o valor de um contador cujo valor é um inteiro sem sinal de 4 bytes. Os provedores usam essa função.

Sintaxe

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

Parâmetros

[in] Provider

O identificador do provedor. Use a variável de identificador que a ferramenta CTRPP gerou para você. Para o nome da variável, consulte o atributo symbol do elemento provider .

Windows Vista: A função PerfStartProvider retorna o identificador.

[in] Instance

Uma estrutura PERF_COUNTERSET_INSTANCE que contém a instância do conjunto de contadores. A função PerfCreateInstance retorna esse ponteiro.

[in] CounterId

Identificador que identifica exclusivamente o contador a ser atualizado no bloco de instância. O identificador é definido no atributo id do elemento counter e deve corresponder ao membro CounterId de uma das estruturas PERF_COUNTER_INFO no bloco de instância. Use a constante de ID do contador que a ferramenta CTRPP gerou para você. Para o nome da constante, consulte o atributo de símbolo do elemento counter .

Windows Vista: A constante de ID do contador não está disponível.

[in] Value

Novo valor do contador de 4 bytes.

Retornar valor

Se a função for bem-sucedida, ela retornará ERROR_SUCCESS.

Se a função falhar, o valor retornado será um código de erro do sistema.

Comentários

Essa é uma função de conveniência para definir dados brutos do contador. Para atualizar os dados brutos do contador por conta própria, use o membro Offset da estrutura PERF_COUNTER_INFO para acessar os dados brutos do contador para um contador específico. O bloco de estrutura PERF_COUNTERSET_INSTANCE contém uma ou mais estruturas de informações de contador.

Você pode usar as funções PerfIncrementULongCounterValue e PerfDecrementULongCounterValue para incrementar ou diminuir o valor do contador, respectivamente.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	perflib.h
Biblioteca	Advapi32.lib
DLL	Advapi32.dll

Confira também

PerfDecrementULongCounterValue

PerfIncrementULongCounterValue

PerfSetCounterRefValue

PerfSetULongLongCounterValue