IPortableDeviceValues::SetValue 메서드(portabledevicetypes.h)

새 값을 추가하거나 기존 값을 덮어씁니다.

구문

HRESULT SetValue(
  [in] REFPROPERTYKEY    key,
  [in] const PROPVARIANT *pValue
);

매개 변수

[in] key

만들거나 덮어쓸 항목을 지정하는 REFPROPERTYKEY 입니다.

[in] pValue

새 값을 지정하는 PROPVARIANT 입니다. SDK는 값을 복사하므로 호출자는 이 메서드를 호출한 후 PropVariantClear 를 호출하여 지역 변수를 해제할 수 있습니다.

반환 값

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

반환 코드 Description
S_OK
메서드가 성공했습니다.

설명

pValue에 대한 VARTYPE이 VT_VECTOR 또는 VT_UI1 경우 NULL 또는 0 크기의 버퍼 설정은 지원되지 않습니다. 예를 들어 pValue.caub.pElems = NULL 또는 pValue.caub.cElems = 0은 허용되지 않습니다.

이 메서드는 컬렉션에서 모든 형식의 값을 검색하는 데 사용할 수 있습니다. 그러나 값 형식을 미리 알고 있는 경우 특수 집합 중 하나를 사용합니다. PROPVARIANT를 직접 사용하는 오버헤드를 방지하기 위해 이 인터페이스의 메서드

기존 값에 키 매개 변수 로 지정된 키가 동일한 경우 경고 없이 기존 값을 덮어씁니다. 기존 키 메모리가 적절하게 해제됩니다.

요구 사항

요구 사항
대상 플랫폼 Windows
헤더 portabledevicetypes.h

추가 정보

IPortableDeviceValues 인터페이스

IPortableDeviceValues::GetValue

IPortableDeviceValues::RemoveValue