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

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.

Retornar valor

O 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.
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.

Comentários

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.

Requisitos

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

Confira também

GetProperties

ISensor