Interfaz IPortableDeviceValues
La interfaz IPortableDeviceValues contiene una colección de pares PROPERTYKEY/PROPVARIANT . Los valores de la colección no necesitan ser el mismo VARTYPE.
Los valores se almacenan como pares clave-valor; cada clave debe ser única en la colección. Los clientes pueden buscar elementos por PROPERTYKEY o índice de base cero. Los valores de datos se almacenan como estructuras PROPVARIANT . Puede agregar o recuperar valores de cualquier tipo mediante los métodos genéricos SetValue y GetValue, o bien agregar elementos mediante el método específico del tipo de datos agregado.
Los métodos Get... requieren que el autor de la llamada libere los valores recuperados correctamente. Los métodos Set... copian el valor en la colección.
Cuando se libera una interfaz IPortableDeviceValues , llama a Clear, que libera la memoria asignada para todos sus miembros correctamente.
Esta interfaz se puede recuperar de un método o, si se requiere un nuevo objeto, llame a CoCreate con CLSID_PortableDeviceValues.
Miembros
La interfaz IPortableDeviceValues hereda de la interfaz IUnknown . IPortableDeviceValues también tiene estos tipos de miembros:
Métodos
La interfaz IPortableDeviceValues tiene estos métodos .
| Método | Descripción |
|---|---|
| Claro | Elimina todos los elementos de la colección. |
| CopyValuesFromPropertyStore | Copia el contenido de un IPropertyStore en la colección. |
| CopyValuesToPropertyStore | Copia todos los valores de una colección en una interfaz IPropertyStore . |
| GetAt | Recupera un valor de la colección mediante el índice de base cero proporcionado. |
| GetBoolValue | Recupera un valor BOOL (tipo VT_BOOL) especificado por una clave. |
| GetBufferValue | Recupera un valor de matriz de bytes (tipo VT_VECTOR | VT_UI1) especificado por una clave. |
| GetCount | Recupera el número de elementos de la colección. |
| GetErrorValue | Recupera un valor HRESULT (tipo VT_ERROR) especificado por una clave. |
| GetFloatValue | Recupera un valor FLOAT (tipo VT_R4) especificado por una clave. |
| GetGuidValue | Recupera un valor GUID (tipo VT_CLSID) especificado por una clave. |
| GetIPortableDeviceKeyCollectionValue | Recupera un valor IPortableDeviceKeyCollection (tipo VT_UNKNOWN) especificado por una clave. |
| GetIPortableDevicePropVariantCollectionValue | Recupera un valor IPortableDevicePropVariantCollection (tipo VT_UNKNOWN) especificado por una clave. |
| GetIPortableDeviceValuesCollectionValue | Recupera un valor IPortableDeviceValuesCollection (tipo VT_UNKNOWN) especificado por una clave. |
| GetIPortableDeviceValuesValue | Recupera un valor IPortableDeviceValues (tipo VT_UNKNOWN) especificado por una clave. |
| GetIUnknownValue | Recupera un valor de interfaz IUnknown (tipo VT_UNKNOWN) especificado por una clave. |
| GetKeyValue | Recupera un valor PROPERTYKEY especificado por una clave. |
| GetSignedIntegerValue | Recupera un valor LONG (tipo VT_I4) especificado por una clave. |
| GetSignedLargeIntegerValue | Recupera un valor LONGLONG (tipo VT_I8) especificado por una clave. |
| GetStringValue | Recupera un valor de cadena (tipo VT_LPWSTR) especificado por una clave. |
| GetUnsignedIntegerValue | Recupera un valor ULONG (tipo VT_UI4) especificado por una clave. |
| GetUnsignedLargeIntegerValue | Recupera un valor ULONGLONG (tipo VT_UI8) especificado por una clave. |
| GetValue | Recupera un valor PROPVARIANT especificado por una clave. |
| RemoveValue | Quita un elemento de la colección. |
| SetBoolValue | Agrega un nuevo valor booleano (tipo VT_BOOL) o sobrescribe uno existente. |
| SetBufferValue | Agrega un nuevo valor BYTE* (tipo VT_VECTOR | VT_UI1) o sobrescribe uno existente. |
| SetErrorValue | Agrega un nuevo valor HRESULT (tipo VT_ERROR) o sobrescribe uno existente. |
| SetFloatValue | Agrega un nuevo valor FLOAT (tipo VT_R4) o sobrescribe uno existente. |
| SetGuidValue | Agrega un nuevo valor GUID (tipo VT_CLSID) o sobrescribe uno existente. |
| SetIPortableDeviceKeyCollectionValue | Agrega un nuevo valor IPortableDeviceKeyCollectionValue (tipo VT_UNKNOWN) o sobrescribe uno existente. |
| SetIPortableDevicePropVariantCollectionValue | Agrega un nuevo valor IPortableDevicePropVariantCollection (tipo VT_UNKNOWN) o sobrescribe uno existente. |
| SetIPortableDeviceValuesCollectionValue | Agrega un nuevo valor IPortableDeviceValuesCollection (tipo VT_UNKNOWN) o sobrescribe uno existente. |
| SetIPortableDeviceValuesValue | Agrega un nuevo valor IPortableDeviceValues (tipo VT_UNKNOWN) o sobrescribe uno existente. |
| SetIUnknownValue | Agrega un nuevo valor IUnknown (tipo VT_UNKNOWN) o sobrescribe uno existente. |
| SetKeyValue | Agrega un nuevo valor PROPERTYKEY (tipo VT_UNKNOWN) o sobrescribe uno existente. |
| SetSignedIntegerValue | Agrega un nuevo valor LONG (tipo VT_I4) o sobrescribe uno existente. |
| SetSignedLargeIntegerValue | Agrega un nuevo valor LONGLONG (tipo VT_I8) o sobrescribe uno existente. |
| SetStringValue | Agrega un nuevo valor de cadena (tipo VT_LPWSTR) o sobrescribe uno existente. |
| SetUnsignedIntegerValue | Agrega un nuevo valor de ULONG (tipo VT_UI4) o sobrescribe uno existente. |
| SetUnsignedLargeIntegerValue | Agrega un nuevo valor de ULONGLONG (tipo VT_UI8) o sobrescribe uno existente. |
| SetValue | Agrega un nuevo valor PROPVARIANT o sobrescribe uno existente. |
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
| Biblioteca |
|
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de