ISensor::SetProperties 메서드(sensorsapi.h)

센서 속성을 지정합니다.

구문

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

[in] pProperties

설정할 속성 및 값 목록을 포함하는 IPortableDeviceValues 인터페이스에 대한 포인터입니다.

[out] ppResults

성공적으로 설정된 속성 목록을 수신하는 IPortableDeviceValues 인터페이스의 주소입니다. 각 속성에는 속성 설정이 성공했는지 여부를 나타내는 연결된 HRESULT 값이 있습니다.

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드	Description
S_OK	메서드가 성공했습니다.
S_FALSE	지정된 속성 중 하나 이상을 설정하라는 요청이 실패했습니다. ppResults를 검사하여 성공한 속성(있는 경우)을 확인합니다.
E_POINTER	NULL이 ppResults에 전달되었습니다.

이 메서드를 사용하면 단일 호출을 수행하여 센서 메이크, 모델 및 일련 번호와 같은 하나 이상의 속성 값을 지정할 수 있습니다.

모든 속성을 설정할 수 있는 것은 아닙니다.

IPortableDeviceValues 는 Windows 이식 가능한 디바이스 API에 의해 정의됩니다.

속성을 설정하는 방법에 대한 예제는 센서 속성 설정 및 검색을 참조하세요.