Método ISensor::SetProperties (sensorsapi.h)

Importante

Use, em vez disso, a API do Sensor UWP.

A API de Sensor baseada em COM foi preterida e não deve ser usada em novos aplicativos. Nenhum recurso ou aprimoramento adicional é planejado e o suporte será limitado.

Especifica as propriedades do sensor.

Sintaxe

HRESULT SetProperties(
  [in]  IPortableDeviceValues *pProperties,
  [out] IPortableDeviceValues **ppResults
);

Parâmetros

[in] pProperties

Ponteiro para uma interface IPortableDeviceValues que contém a lista de propriedades e valores a serem definidos.

[out] ppResults

Endereço de uma interface IPortableDeviceValues que recebe a lista de propriedades que foram definidas com êxito. Cada propriedade tem um valor HRESULT associado, que indica se a definição da propriedade foi bem-sucedida.

Valor de retorno

O método retorna um HRESULT. Os valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir.

Código de retorno	Description
S_OK	O método foi bem-sucedido.
S_FALSE	Falha na solicitação para definir uma ou mais das propriedades especificadas. Inspecione ppResults para determinar quais propriedades, se houver, foram bem-sucedidas.
E_POINTER	NULL foi passado para ppResults.

Observações

Esse método permite que você especifique os valores de uma ou mais propriedades, como a criação do sensor, o modelo e o número de série, fazendo uma única chamada.

Nem todas as propriedades podem ser definidas.

IPortableDeviceValues é definido pela API de Dispositivos Portáteis do Windows.

Exemplos

Para obter um exemplo de como definir propriedades, consulte Configurando e recuperando propriedades do sensor.

Requirements

Requirement	Value
Cliente mínimo suportado	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo compatível	Nenhum compatível
da Plataforma de Destino	Windows
Header	sensorsapi.h
Library	Sensorsapi.lib
de DLL	Sensorsapi.dll

Consulte também

GetProperties

ISensor