Função PdhGetRawCounterValue (pdh.h)

  • Artigo

Retorna o valor bruto atual do contador.

Sintaxe

PDH_FUNCTION PdhGetRawCounterValue(
  [in]  PDH_HCOUNTER     hCounter,
  [out] LPDWORD          lpdwType,
  [out] PPDH_RAW_COUNTER pValue
);

Parâmetros

[in] hCounter

Identificador do contador do qual recuperar o valor bruto atual. A função PdhAddCounter retorna esse identificador.

[out] lpdwType

Recebe o tipo de contador. Para obter uma lista de tipos de contador, consulte a seção Tipos de contador do Kit de Implantação do Windows Server 2003. Esse parâmetro é opcional.

[out] pValue

Uma estrutura PDH_RAW_COUNTER que recebe o valor do contador.

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 ou um código de erro PDH. Veja a seguir os valores possíveis.

Código de retorno Descrição
PDH_INVALID_ARGUMENT
 Um parâmetro não é válido ou está formatado incorretamente.
PDH_INVALID_HANDLE
 O identificador do contador não é válido.

Comentários

Os dados do contador são bloqueados (protegidos) durante a chamada para PdhGetRawCounterValue para evitar alterações durante o processamento da chamada.

Se a instância de contador especificada não existir, essa função retornará ERROR_SUCCESS e o membro CStatus da estrutura PDH_RAW_COUNTER conterá PDH_CSTATUS_NO_INSTANCE.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho pdh.h
Biblioteca Pdh.lib
DLL Pdh.dll

Confira também

PdhCalculateCounterFromRawValue

PdhCollectQueryData

PdhGetFormattedCounterValue