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

Recupera várias propriedades do sensor.

Sintaxe

HRESULT GetProperties(
  [in]  IPortableDeviceKeyCollection *pKeys,
  [out] IPortableDeviceValues        **ppProperties
);

Parâmetros

[in] pKeys

Ponteiro para uma interface IPortableDeviceKeyCollection que contém a coleção PROPERTYKEY para os valores de propriedade que estão sendo solicitados. Defina como NULL para recuperar todas as propriedades com suporte.

[out] ppProperties

Endereço de um ponteiro IPortableDeviceValues que recebe o ponteiro para os valores de propriedade solicitados.

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	O driver do sensor não dá suporte a pelo menos uma das propriedades especificadas. Cada propriedade sem suporte PROPVARIANT retornada por meio da interface IPortableDeviceValues terá seu valor de erro definido como HRESULT_FROM_WIN32 (ERROR_NOT_FOUND).
E_POINTER	NULL foi passado para ppProperties.

Comentários

Esse método permite que você recupere os valores de várias propriedades, como a criação do sensor, o modelo e o número de série, fazendo uma única chamada. Para recuperar uma única propriedade, chame ISensor::GetProperty.

As interfaces IPortableDeviceKeyCollection e IPortableDeviceValues são definidas pela API dispositivos portáteis do Windows.

Exemplos

Para obter um exemplo de como recuperar propriedades de um sensor, 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

ISensor

Propriedades do sensor

SetProperties