IVdsVolume2::GetProperties2-Methode (vds.h)

  • Artikel

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API abgelöst.]

Gibt Eigenschafteninformationen für das aktuelle Volume zurück. Diese Methode ist identisch mit der IVdsVolume::GetProperties-Methode, mit der Ausnahme, dass sie anstelle einer VDS_VOLUME_PROP-Struktur eine VDS_VOLUME_PROP2-Struktur zurückgibt.

Syntax

HRESULT GetProperties2(
  [out] VDS_VOLUME_PROP2 *pVolumeProperties
);

Parameter

[out] pVolumeProperties

Die Adresse der VDS_VOLUME_PROP2 Struktur zugeordnet und vom Aufrufer übergeben. VDS weist Arbeitsspeicher für die pwszName-Memberzeichenfolge zu. Aufrufer müssen die Zeichenfolge mithilfe der Funktion CoTaskMemFree freigeben.

Rückgabewert

Diese Methode kann HRESULT-Standardwerte wie E_INVALIDARG oder E_OUTOFMEMORY und VDS-spezifische Rückgabewerte zurückgeben. Es kann auch konvertierte Systemfehlercodes mithilfe des makros HRESULT_FROM_WIN32 zurückgeben. Fehler können vom VDS selbst oder vom zugrunde liegenden VDS-Anbieter stammen, der verwendet wird. Folgende Rückgabewerte sind möglich.

Rückgabecode/-wert BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich abgeschlossen.
VDS_S_PROPERTIES_INCOMPLETE
0x00042715L
 Einige, aber nicht alle Eigenschaften wurden erfolgreich abgerufen. Beachten Sie, dass es viele mögliche Gründe dafür gibt, dass nicht alle Eigenschaften abgerufen werden, einschließlich der Geräteentfernung.

Hinweise

Diese Methode ruft den eindeutigen Volumebezeichner für ein Volume ab. Die Struktur, die diesen Bezeichner enthält, ist VDS_VOLUME_PROP2, nicht VDS_VOLUME_PROP.

Beachten Sie, dass ein eindeutiger Volumebezeichner nicht mit einem Volume-GUID-Pfad identisch ist. Um die Volume-GUID-Pfade für ein Volume zu finden, verwenden Sie die IVdsVolumeMF3::QueryVolumeGuidPathnames-Methode .

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vds.h
Bibliothek Uuid.lib

Weitere Informationen

IVdsVolume2