Método ISensorDataReport::GetSensorValue (sensorsapi.h)

Recupera um único valor de campo de dados do relatório de dados.

Sintaxe

HRESULT GetSensorValue(
  [in]  REFPROPERTYKEY pKey,
  [out] PROPVARIANT    *pValue
);

[in] pKey

REFPROPERTYKEY indicando o campo de dados a ser recuperado.

[out] pValue

Endereço de um PROPVARIANT que recebe o valor do campo de dados.

Esse método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	O campo de dados não foi encontrado.
E_POINTER	NULL foi passado para pValue.

O campo de dados definido pela plataforma PROPERTYKEYs é definido em Sensors.h.

Para obter um exemplo de como recuperar um valor de campo de dados do sensor, consulte Recuperando valores de dados do sensor.

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	sensorsapi.h
Biblioteca	Sensorsapi.lib
DLL	Sensorsapi.dll