Compartir a través de

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

  • Artículo

El método GetReferences devuelve una matriz de punteros a objetos IMDSPStorage que componen las referencias contenidas en un almacenamiento de asociaciones, como una que representa objetos de lista de reproducción o álbum.

Sintaxis

HRESULT GetReferences(
  [out] DWORD        *pdwRefs,
  [out] IMDSPStorage ***pppISPStorage
);

Parámetros

[out] pdwRefs

Puntero al recuento de punteros de interfaz IWMDMStorage que se devuelven en pppIWMDMStorage.

[out] pppISPStorage

Puntero a un puntero a la matriz de punteros de interfaz IWMDMStorage que representan referencias en un almacenamiento. Estas referencias pueden, por ejemplo, representar elementos de una lista de reproducción o un álbum. El orden de las referencias coincide con el orden de esta matriz. El proveedor de servicios debe asignar memoria para 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
Para obtener una lista extensa de posibles códigos de error, consulte Códigos de error.

Comentarios

Windows Media Administrador de dispositivos usa este método para obtener las referencias en un almacenamiento de asociación, como una lista de reproducción o un álbum.

Si el almacenamiento tiene referencias a uno o varios elementos que se han eliminado del dispositivo, el SP no debe incluir estas referencias en las referencias devueltas. El SP debe indicar dicha condición devolviendo S_FALSE. La aplicación puede optar por actualizar el objeto de almacenamiento de asociación mediante las referencias conocidas que se devuelven aquí. El SP también puede actualizar las referencias en sí.

Si el recuento de referencias es 0, el proveedor de servicios debe devolver una matriz de referencias con 0 elementos.

Requisitos

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

Consulte también

Interfaz IMDSPStorage4

IMDSPStorage4::SetReferences