IPortableDeviceProperties::SetValues 메서드(portabledeviceapi.h)

아티클
08/25/2023

SetValues 메서드는 디바이스의 지정된 개체에서 하나 이상의 속성을 추가하거나 수정합니다.

구문

HRESULT SetValues(
  [in]  LPCWSTR               pszObjectID,
  [in]  IPortableDeviceValues *pValues,
  [out] IPortableDeviceValues **ppResults
);

매개 변수

[in] pszObjectID

수정할 개체의 개체 ID를 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 디바이스를 지정하려면 WPD_DEVICE_OBJECT_ID 사용합니다.

[in] pValues

설정할 하나 이상의 속성/값 쌍이 포함된 IPortableDeviceValues 인터페이스에 대한 포인터입니다. 기존 값을 덮어씁니다.

[out] ppResults

속성/HRESULT 값의 컬렉션을 포함하는 IPortableDeviceValues 인터페이스에 대한 포인터를 수신하는 변수의 주소입니다. 각 값(VT_ERROR 형식)은 속성 집합 시도의 성공 또는 실패를 설명합니다. 호출자는 이 인터페이스가 완료되면 이 인터페이스를 해제해야 합니다.

반환 값

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

반환 코드	설명
S_OK	지정된 모든 속성 값이 업데이트되었습니다.
S_FALSE	하나 이상의 속성을 수정할 수 없습니다. 검색된 ppResults 매개 변수에 VT_ERROR 형식의 HRESULT를 가질 수 없는 항목입니다.

설명

속성을 삭제하려면 IPortableDeviceProperties::D elete를 호출합니다. 속성은 WPD_PROPERTY_ATTRIBUTE_CAN_WRITE 특성이 True인 경우에만 삭제할 수 있습니다. 이 특성은 GetPropertyAttributes를 호출하여 검색할 수 있습니다.