Função PdhGetRawCounterValue (pdh.h)
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 |
|---|---|
|
Um parâmetro não é válido ou está formatado incorretamente. |
|
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 |