다음을 통해 공유


IPortableDeviceValues 인터페이스

IPortableDeviceValues 인터페이스에는 PROPERTYKEY/PROPVARIANT 쌍의 컬렉션이 있습니다. 컬렉션의 값이 동일한 VARTYPE일 필요는 없습니다.

값은 키-값 쌍으로 저장됩니다. 각 키는 컬렉션에서 고유해야 합니다. 클라이언트는 PROPERTYKEY 또는 0부터 시작하는 인덱스로 항목을 검색할 수 있습니다. 데이터 값은 PROPVARIANT 구조로 저장됩니다. 제네릭 메서드 SetValueGetValue를 사용하여 모든 형식의 값을 추가하거나 검색하거나 추가된 데이터 형식과 관련된 메서드를 사용하여 항목을 추가할 수 있습니다.

Get... 메서드를 사용하려면 호출자가 검색된 값을 적절하게 해제해야 합니다. Set... 메서드는 값을 컬렉션에 복사합니다.

IPortableDeviceValues 인터페이스가 릴리스되면 Clear를 호출하여 모든 멤버에 대해 할당된 메모리를 적절하게 해제합니다.

이 인터페이스는 메서드에서 검색하거나 새 개체가 필요한 경우 CLSID_PortableDeviceValues 사용하여 CoCreate를 호출할 수 있습니다.

멤버

IPortableDeviceValues 인터페이스는IUnknown 인터페이스에서 상속됩니다. IPortableDeviceValues 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IPortableDeviceValues 인터페이스에는 이러한 메서드가 있습니다.

메서드 설명
지우기 컬렉션에서 모든 항목을 삭제합니다.
CopyValuesFromPropertyStore IPropertyStore의 내용을 컬렉션에 복사합니다.
CopyValuesToPropertyStore 컬렉션의 모든 값을 IPropertyStore 인터페이스에 복사합니다.
GetAt 제공된 0부터 시작하는 인덱스를 사용하여 컬렉션에서 값을 검색합니다.
GetBoolValue 키로 지정된 BOOL 값(VT_BOOL 형식)을 검색합니다.
GetBufferValue 바이트 배열 값을 검색합니다(형식 VT_VECTOR | 키로 지정된 VT_UI1)입니다.
GetCount 컬렉션의 항목 수를 검색합니다.
GetErrorValue 키로 지정된 HRESULT 값(VT_ERROR 형식)을 검색합니다.
GetFloatValue 키로 지정된 FLOAT 값(VT_R4 형식)을 검색합니다.
GetGuidValue 키로 지정된 GUID 값(VT_CLSID 형식)을 검색합니다.
GetIPortableDeviceKeyCollectionValue 키로 지정된 IPortableDeviceKeyCollection 값(VT_UNKNOWN 형식)을 검색합니다.
GetIPortableDevicePropVariantCollectionValue 키로 지정된 IPortableDevicePropVariantCollection 값(VT_UNKNOWN 형식)을 검색합니다.
GetIPortableDeviceValuesCollectionValue 키로 지정된 IPortableDeviceValuesCollection 값(VT_UNKNOWN 형식)을 검색합니다.
GetIPortableDeviceValuesValue 키로 지정된 IPortableDeviceValues 값(VT_UNKNOWN 형식)을 검색합니다.
GetIUnknownValue 키로 지정된 IUnknown 인터페이스 값(VT_UNKNOWN 형식)을 검색합니다.
GetKeyValue 키로 지정된 PROPERTYKEY 값을 검색합니다.
GetSignedIntegerValue 키로 지정된 LONG 값(VT_I4 형식)을 검색합니다.
GetSignedLargeIntegerValue 키로 지정된 LONGLONG 값(VT_I8 형식)을 검색합니다.
GetStringValue 키로 지정된 문자열 값(VT_LPWSTR 형식)을 검색합니다.
GetUnsignedIntegerValue 키로 지정된 ULONG 값(VT_UI4 형식)을 검색합니다.
GetUnsignedLargeIntegerValue 키로 지정된 ULONGLONG 값(VT_UI8 형식)을 검색합니다.
GetValue 키로 지정된 PROPVARIANT 값을 검색합니다.
RemoveValue 컬렉션에서 항목을 제거합니다.
SetBoolValue 부울 값(VT_BOOL 형식)을 추가하거나 기존 값을 덮어씁니다.
SetBufferValue BYTE* 값을 추가합니다(형식 VT_VECTOR | VT_UI1) 또는 기존 항목을 덮어씁니다.
SetErrorValue HRESULT 값(VT_ERROR 형식)을 추가하거나 기존 값을 덮어씁니다.
SetFloatValue FLOAT 값(VT_R4 형식)을 추가하거나 기존 값을 덮어씁니다.
SetGuidValue GUID 값(VT_CLSID 형식)을 추가하거나 기존 GUID 값을 덮어씁니다.
SetIPortableDeviceKeyCollectionValue IPortableDeviceKeyCollectionValue 값(VT_UNKNOWN 형식)을 추가하거나 기존 값을 덮어씁니다.
SetIPortableDevicePropVariantCollectionValue IPortableDevicePropVariantCollection 값(VT_UNKNOWN 형식)을 추가하거나 기존 값을 덮어씁니다.
SetIPortableDeviceValuesCollectionValue IPortableDeviceValuesCollection 값(VT_UNKNOWN 형식)을 추가하거나 기존 값을 덮어씁니다.
SetIPortableDeviceValuesValue IPortableDeviceValues 값(VT_UNKNOWN 형식)을 추가하거나 기존 값을 덮어씁니다.
SetIUnknownValue IUnknown 값(VT_UNKNOWN 형식)을 추가하거나 기존 값을 덮어씁니다.
SetKeyValue PROPERTYKEY (VT_UNKNOWN 형식) 값을 추가하거나 기존 값을 덮어씁니다.
SetSignedIntegerValue LONG 값(VT_I4 형식)을 추가하거나 기존 값을 덮어씁니다.
SetSignedLargeIntegerValue LONGLONG 값(VT_I8 형식)을 추가하거나 기존 값을 덮어씁니다.
SetStringValue 새 문자열 값(VT_LPWSTR 형식)을 추가하거나 기존 문자열 값을 덮어씁니다.
SetUnsignedIntegerValue ULONG 값(VT_UI4 형식)을 추가하거나 기존 값을 덮어씁니다.
SetUnsignedLargeIntegerValue ULONGLONG 값(VT_UI8 형식)을 추가하거나 기존 값을 덮어씁니다.
SetValue PROPVARIANT 값을 추가하거나 기존 값을 덮어씁니다.

요구 사항

요구 사항
헤더
PortableDeviceTypes.h
라이브러리
PortableDeviceGUIDs.lib

추가 정보

컬렉션 인터페이스