Método IWMDMStorage3::SetEnumPreference (mswmdm.h)

Artículo
03/15/2023

El método SetEnumPreference establece el modo de vista preferido para el almacenamiento.

Sintaxis

HRESULT SetEnumPreference(
  [in, out] WMDM_STORAGE_ENUM_MODE *pMode,
  [in]      DWORD                  nViews,
  [in]      WMDMMetadataView       *pViews
);

Parámetros

[in, out] pMode

Modo deseado del enumerador de almacenamiento. Para obtener más información sobre el modo, consulte WMDM_STORAGE_ENUM_MODE. Si el valor de pMode se establece en ENUM_MODE_USE_DEVICE_PREF, al devolverlo se establece en ENUM_MODE_RAW o ENUM_MODE_METADATA_VIEWS, en función de la preferencia del dispositivo.

[in] nViews

Número de definiciones de vista proporcionadas.

Este parámetro se omite si el valor de pMode es ENUM_MODE_RAW o si el valor de pMode es ENUM_MODE_USE_DEVICE_PREF y el dispositivo no prefiere vistas de metadatos.

Si el valor de pMode es ENUM_MODE_METADATA_VIEWS o si el valor de pMode es ENUM_MODE_USE_DEVICE_PREF y el dispositivo prefiere vistas de metadatos, este parámetro todavía puede ser 0. En este caso, Windows Media Administrador de dispositivos usa sus vistas de metadatos predeterminadas.

Si el valor de nViews es 0, ppViews debe ser NULL. Si el valor de nViews no es 0, ppViews debe apuntar a una matriz de estructuras WMDMMetadataView con elementos nViews .

[in] pViews

Matriz de definiciones de vista. La longitud de la matriz debe ser igual a nViews.

Este parámetro se omite si el valor de pMode es ENUM_MODE_RAW o si el valor de pMode es ENUM_MODE_USE_DEVICE_PREF y el dispositivo no prefiere vistas de metadatos.

Si el valor de pMode es ENUM_MODE_METADATA_VIEWS o si el valor de pMode es ENUM_MODE_USE_DEVICE_PREF y el dispositivo prefiere vistas de metadatos, este parámetro todavía puede ser NULL. En este caso, Windows Media Administrador de dispositivos usa sus vistas de metadatos predeterminadas.

El valor de este parámetro debe ser NULL si el valor de nViews es 0. Si el valor de nViews no es 0, ppViews debe apuntar a una matriz de estructuras WMDMMetadataView con elementos nViews .

Valor devuelto

El método devuelve un valor HRESULT. En la tabla siguiente se enumeran todos los valores posibles.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_OUTOFMEMORY	No hay suficiente memoria para asignar el elemento.
E_INVALIDARG	Uno o varios parámetros no son válidos.
WMDM_E_NOT_CERTIFIED	El autor de la llamada no tiene los derechos para ejecutar esta operación.
WMDM_E_NOTSUPPORTED	El objeto no admite este método.
E_FAIL	Se ha producido un error no especificado.

Comentarios

Windows Media Administrador de dispositivos puede presentar vistas de metadatos del contenido en el dispositivo. Recorre todo el contenido de un almacenamiento de nivel superior (como la memoria interna o una tarjeta de almacenamiento) y devuelve un enumerador de almacenamiento que presenta el contenido organizado por los metadatos del contenido. La definición de una vista de metadatos se proporciona a través de una estructura WMDMMetadataView .

Este comportamiento se controla mediante el parámetro pMode . Si pMode se establece en ENUM_MODE_RAW, Windows Media Administrador de dispositivos devuelve un enumerador que refleja la jerarquía del sistema de archivos en el almacenamiento del dispositivo. Si el valor de pMode se establece en ENUM_MODE_METADATA_VIEWS, Windows Media Administrador de dispositivos genera vistas de metadatos.

Los dispositivos indican su preferencia estableciendo el parámetro de dispositivo UseMetadataViews en el momento en que se instala el dispositivo. Para obtener más información sobre UseMetadataViews, consulte Parámetros del dispositivo. Si la aplicación permitirá que el dispositivo decida el tipo de enumerador de almacenamiento devuelto, debe establecer pMode en ENUM_MODE_USE_DEVICE_PREF.

Después de llamar a este método, las llamadas posteriores a IWMDMStorage::EnumStorage se comportarán según la preferencia de enumeración de almacenamiento establecida por este método. Se puede llamar a este método de nuevo para cambiar el comportamiento de las llamadas de IWMDMStorage::EnumStorage posteriores.

Normalmente, se debe llamar a este método en el almacenamiento de nivel superior. Si se llama a este método en cualquiera de los almacenamientos en la vista de metadatos, devolverá WMDM_E_NOTSUPPORTED.