IPortableDeviceContent2::UpdateObjectWithPropertiesAndData 메서드(portabledeviceapi.h)

UpdateObjectWithPropertiesAndData 메서드는 디바이스에 있는 속성 및 데이터를 사용하여 개체를 업데이트합니다.

구문

HRESULT UpdateObjectWithPropertiesAndData(
  [in]      LPCWSTR               pszObjectID,
  [in]      IPortableDeviceValues *pProperties,
  [out]     IStream               **ppData,
  [in, out] DWORD                 *pdwOptimalWriteBufferSize
);

매개 변수

[in] pszObjectID

업데이트할 개체의 식별자입니다.

[in] pProperties

업데이트할 개체 속성을 지정하는 IPortableDeviceValues 인터페이스입니다.

[out] ppData

개체 데이터가 디바이스로 전송되는 IStream 인터페이스입니다.

[in, out] pdwOptimalWriteBufferSize

개체 데이터를 ppData에 쓰기 위한 최적의 버퍼 크기이거나 버퍼 크기가 무시되는 경우 NULL입니다.

반환 값

메서드가 성공하면 S_OK 반환합니다. 다른 HRESULT 값은 호출이 실패했음을 나타냅니다.

설명

디바이스 형식 및 개체 형식은 데이터 자체에서 일부 개체 속성을 파생시킬 수 있습니다. 또는 데이터에 의존하는 속성 값을 가질 수 있습니다. 예를 들어 음악 트랙에는 애플리케이션이 IPortableDeviceContent::CreateObjectWithPropertiesAndData 메서드를 호출할 때 지정된 기간 속성이 있습니다. 이 트랙이 기본 리소스(WPD_RESOURCE_DEFAULT)로 저장되면 애플리케이션에서 업데이트할 수 있습니다. 또한 애플리케이션은 기간 속성을 업데이트할 수도 있습니다. 이 메서드를 사용하면 애플리케이션에서 두 업데이트를 동시에 수행할 수 있습니다.

ppData 매개 변수에서 참조하는 개체에서 IStream::Commit 메서드가 호출될 때까지 업데이트가 완료되지 않습니다.

진행 중인 데이터 전송을 중단하려면 애플리케이션이 ppData 매개 변수에서 참조하는 개체에서 IStream::Revert 메서드를 호출해야 합니다.

업데이트 작업이 완료되었거나 취소된 후 ppData 매개 변수에서 참조하는 IStream 인터페이스 개체를 해제해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	portabledeviceapi.h