Método IMDSPStorage4::SetReferences (mswmdm.h)

El método SetReferences establece las referencias contenidas en un almacenamiento que tiene referencias (como lista de reproducción o álbum), sobrescribiendo las referencias existentes anteriormente contenidas en este almacenamiento.

Sintaxis

HRESULT SetReferences(
  [in] DWORD        dwRefs,
  [in] IMDSPStorage **ppISPStorage
);

Parámetros

[in] dwRefs

Recuento de punteros de interfaz IMDSPStorage contenidos en la matriz pasada. Cero es un valor aceptable y restablece el almacenamiento para que contenga cero referencias. El propio almacenamiento no se elimina en este caso.

[in] ppISPStorage

Puntero a una matriz de punteros de interfaz IMDSPStorage usados para establecer referencias en un almacenamiento. El orden de las referencias coincide con el orden de los punteros de interfaz IWMDMStorage correspondientes de esta matriz. NULL es un valor aceptable si dwRefs también es cero.

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

Para obtener una lista extensa de posibles códigos de error, consulte Códigos de error.

Comentarios

Cualquier objeto IMDSPStorage válido puede estar incluido en la matriz ppIMDSPStorage . Esto incluye carpetas y otros almacenamientos que contienen referencias a sí mismos (creando, por ejemplo, una lista de reproducción de listas de reproducción).

Dependiendo del nivel de compatibilidad en el dispositivo (ya sea compatible con listas de reproducción o listas de reproducción anidadas), el proveedor de servicios debe controlar este método correctamente. Si el dispositivo no tiene el nivel de admitido necesario para la matriz de referencia pasada, el proveedor de servicios debe devolver WMDM_E_NOTSUPPORTED.

Si la referencia contiene un almacenamiento eliminado, se debe devolver WMDM_E_INTERFACEDEAD.

El método SetReferences sigue un modelo de borrado y carga. Las referencias pasadas incluyen un conjunto completo y deben reemplazar todas las referencias existentes en el objeto de almacenamiento por completo.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	mswmdm.h
Library	Mssachlp.lib

Consulte también

Interfaz IMDSPStorage4

IMDSPStorage4::GetReferences