IWICMetadataWriter::SetValueByIndex 메서드(wincodecsdk.h)

메타데이터 항목을 지정된 인덱스로 설정합니다.

구문

HRESULT SetValueByIndex(
  [in] UINT              nIndex,
  [in] const PROPVARIANT *pvarSchema,
  [in] const PROPVARIANT *pvarId,
  [in] const PROPVARIANT *pvarValue
);

매개 변수

[in] nIndex

형식: UINT

메타데이터 항목을 배치할 인덱스입니다.

[in] pvarSchema

형식: const PROPVARIANT*

메타데이터 항목의 스키마 속성에 대한 포인터입니다.

[in] pvarId

형식: const PROPVARIANT*

메타데이터 항목의 ID 속성에 대한 포인터입니다.

[in] pvarValue

형식: const PROPVARIANT*

지정된 인덱스에서 설정할 메타데이터 값에 대한 포인터입니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

항목을 제거한 후 나머지 메타데이터 항목이 위로 이동하여 비어 있는 메타데이터 항목 위치를 차지할 것으로 예상합니다. 따라서 나머지 메타데이터 항목과 개수에 대한 인덱스가 변경됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	WINDOWS XP SP2, Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	wincodecsdk.h
라이브러리	Windowscodecs.lib
DLL	Windowscodecs.dll