Método IWMDMStorage4::SetReferences (mswmdm.h)
El método SetReferences establece las referencias contenidas en un almacenamiento que tiene referencias (por ejemplo, una lista de reproducción o un álbum), sobrescribiendo las referencias existentes anteriormente mantenidas por el almacenamiento.
Sintaxis
HRESULT SetReferences(
[in] DWORD dwRefs,
[in] IWMDMStorage **ppIWMDMStorage
);
Parámetros
[in] dwRefs
Recuento de punteros de interfaz IWMDMStorage en ppIWMDMStorage. Cero es un valor aceptable y borra todas las referencias del almacenamiento. El propio almacenamiento no se elimina en este caso.
[in] ppIWMDMStorage
Puntero a una matriz de punteros de interfaz IWMDMStorage a los que hace referencia el almacenamiento. El almacenamiento conserva este orden. NULL es un valor aceptable si dwRefs también es cero. El autor de la llamada es responsable de asignar y liberar esta matriz.
Valor devuelto
El método devuelve un valor HRESULT. Todos los métodos de interfaz de Windows Media Administrador de dispositivos pueden devolver cualquiera de las siguientes clases de códigos de error:
- Códigos de error COM estándar
- Códigos de error de Windows convertidos en valores HRESULT
- Códigos de error de windows Media Administrador de dispositivos
Comentarios
Este método se usa para establecer referencias en objetos que se componen de referencias, como listas de reproducción o álbumes. Si un dispositivo no admite metadatos, es probable que este método no se admita.
Cualquier objeto IWMDMStorage válido se puede contener en la matriz ppIWMDMStorage . Esto incluye carpetas y otros almacenamientos que especifican referencias a sí mismos (creando, por ejemplo, una lista de reproducción de listas de reproducción). El propio dispositivo determina cómo se controla cualquier caso concreto del objeto de referencia. Windows Media Administrador de dispositivos no aplica ninguna regla más allá de la validez de IWMDMStorage. Tenga en cuenta el caso de una lista de reproducción que contiene referencias de lista de reproducción anidadas. En un dispositivo, esto no se permite y se produce un error en SetReferences . En otro dispositivo, esto se permite; la reproducción simplemente atraviesa todo el conjunto de referencias contenidas en orden de profundidad.
La situación puede surgir cuando un puntero de interfaz IWMDMStorage4 corresponde a un almacenamiento que ya no existe en el dispositivo. WMDM_E_INTERFACEDEAD se devuelve en este caso.
Requisitos
Requisito | Value |
---|---|
Plataforma de destino | Windows |
Encabezado | mswmdm.h |
Library | Mssachlp.lib |