IWMDMStorage3::SetEnumPreference-Methode (mswmdm.h)

Artikel
08/25/2023

Die SetEnumPreference-Methode legt den bevorzugten Ansichtsmodus für den Speicher fest.

Syntax

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

Parameter

[in, out] pMode

Gewünschter Modus des Speicherenumerators. Weitere Informationen zum Modus finden Sie unter WMDM_STORAGE_ENUM_MODE. Wenn der Wert von pMode auf ENUM_MODE_USE_DEVICE_PREF festgelegt ist, wird er bei der Rückgabe basierend auf der Geräteeinstellung auf ENUM_MODE_RAW oder ENUM_MODE_METADATA_VIEWS festgelegt.

[in] nViews

Anzahl der bereitgestellten Ansichtsdefinitionen.

Dieser Parameter wird ignoriert, wenn der Wert von pMode ENUM_MODE_RAW ist oder wenn der Wert von pMode ENUM_MODE_USE_DEVICE_PREF ist und das Gerät keine Metadatenansichten bevorzugt.

Wenn der Wert von pMode ENUM_MODE_METADATA_VIEWS ist oder der Wert von pMode ENUM_MODE_USE_DEVICE_PREF ist und das Gerät Metadatenansichten bevorzugt, kann dieser Parameter immer noch 0 sein. In diesem Fall verwendet Windows Media Geräte-Manager die Standardmetadatenansichten.

Wenn der Wert von nViews 0 ist, muss ppViewsNULL sein. Wenn der Wert von nViews nicht 0 ist, muss ppViews auf ein Array von WMDMMetadataView-Strukturen mit nViews-Elementen verweisen.

[in] pViews

Array von Ansichtsdefinitionen. Die Länge des Arrays muss gleich nViews sein.

Dieser Parameter wird ignoriert, wenn der Wert von pMode ENUM_MODE_RAW ist oder wenn der Wert von pMode ENUM_MODE_USE_DEVICE_PREF ist und das Gerät keine Metadatenansichten bevorzugt.

Wenn der Wert von pMode ENUM_MODE_METADATA_VIEWS ist oder der Wert von pMode ENUM_MODE_USE_DEVICE_PREF ist und das Gerät Metadatenansichten bevorzugt, kann dieser Parameter weiterhin NULL sein. In diesem Fall verwendet Windows Media Geräte-Manager die Standardmetadatenansichten.

Der Wert dieses Parameters muss NULL sein, wenn der Wert von nViews 0 ist. Wenn der Wert von nViews nicht 0 ist, muss ppViews auf ein Array von WMDMMetadataView-Strukturen mit nViews-Elementen verweisen.

Rückgabewert

Die Methode gibt ein HRESULT zurück. In der folgenden Tabelle sind alle möglichen Werte aufgeführt.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um das Element zuzuordnen.
E_INVALIDARG	Mindestens ein Parameter ist ungültig.
WMDM_E_NOT_CERTIFIED	Der Aufrufer verfügt nicht über die Rechte zum Ausführen dieses Vorgangs.
WMDM_E_NOTSUPPORTED	Diese Methode wird vom -Objekt nicht unterstützt.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.

Hinweise

Windows Media Geräte-Manager können Metadatenansichten des Inhalts auf dem Gerät darstellen. Er durchläuft den gesamten Inhalt eines Speichers auf oberster Ebene (z. B. interner Speicher oder einen Speicher Karte) und gibt einen Speicherenumerator zurück, der den Inhalt darstellt, der nach den Metadaten des Inhalts organisiert ist. Die Definition einer Metadatenansicht wird über eine WMDMMetadataView-Struktur bereitgestellt.

Dieses Verhalten wird durch den pMode-Parameter gesteuert. Wenn pMode auf ENUM_MODE_RAW festgelegt ist, gibt Windows Media Geräte-Manager einen Enumerator zurück, der die Hierarchie des Dateisystems im Speicher des Geräts widerspiegelt. Wenn pMode auf ENUM_MODE_METADATA_VIEWS festgelegt ist, generiert Windows Media Geräte-Manager Metadatenansichten.

Geräte geben ihre Präferenz an, indem sie den Geräteparameter UseMetadataViews zum Zeitpunkt der Installation des Geräts festlegen. Weitere Informationen zu UseMetadataViews finden Sie unter Geräteparameter. Wenn die Anwendung dem Gerät die Entscheidung über die Art des zurückgegebenen Speicherenumerators ermöglicht, sollte pMode auf ENUM_MODE_USE_DEVICE_PREF festgelegt werden.

Nachdem diese Methode aufgerufen wurde, verhalten sich spätere Aufrufe von IWMDMStorage::EnumStorage entsprechend der von dieser Methode festgelegten Speicheraufzählungseinstellung. Diese Methode kann erneut aufgerufen werden, um das Verhalten nachfolgender IWMDMStorage::EnumStorage-Aufrufe zu ändern.

Diese Methode sollte in der Regel im Speicher der obersten Ebene aufgerufen werden. Wenn diese Methode in einem der Speicher in der Metadatenansicht aufgerufen wird, gibt sie WMDM_E_NOTSUPPORTED zurück.