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