IPortableDeviceValues 인터페이스
IPortableDeviceValues 인터페이스에는 PROPERTYKEY/PROPVARIANT 쌍의 컬렉션이 있습니다. 컬렉션의 값이 동일한 VARTYPE일 필요는 없습니다.
값은 키-값 쌍으로 저장됩니다. 각 키는 컬렉션에서 고유해야 합니다. 클라이언트는 PROPERTYKEY 또는 0부터 시작하는 인덱스로 항목을 검색할 수 있습니다. 데이터 값은 PROPVARIANT 구조로 저장됩니다. 제네릭 메서드 SetValue 및 GetValue를 사용하여 모든 형식의 값을 추가하거나 검색하거나 추가된 데이터 형식과 관련된 메서드를 사용하여 항목을 추가할 수 있습니다.
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 값을 추가하거나 기존 값을 덮어씁니다. |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 |
|
| 라이브러리 |
|