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

여러 센서 속성을 검색합니다.

구문

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

[in] pKeys

요청되는 속성 값에 대한 PROPERTYKEY 컬렉션을 포함하는 IPortableDeviceKeyCollection 인터페이스에 대한 포인터입니다. NULL로 설정하여 지원되는 모든 속성을 검색합니다.

[out] ppProperties

요청된 속성 값에 대한 포인터를 수신하는 IPortableDeviceValues 포인터의 주소입니다.

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

반환 코드	Description
S_OK	메서드가 성공했습니다.
S_FALSE	센서 드라이버는 지정된 속성 중 하나 이상을 지원하지 않습니다. IPortableDeviceValues 인터페이스를 통해 반환된 지원되지 않는 각 속성 PROPVARIANT에는 오류 값이 HRESULT_FROM_WIN32(ERROR_NOT_FOUND)로 설정됩니다.
E_POINTER	NULL은 ppProperties에 대해 전달되었습니다.

이 메서드를 사용하면 단일 호출을 수행하여 센서 메이크, 모델 및 일련 번호와 같은 여러 속성의 값을 검색할 수 있습니다. 단일 속성을 검색하려면 ISensor::GetProperty를 호출합니다.

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

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