Freigeben über


IVdsVolume::GetProperties-Methode (vds.h)

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

Gibt Eigenschaftsdetails des aktuellen Volumes zurück.

Syntax

HRESULT GetProperties(
  [out] VDS_VOLUME_PROP *pVolumeProperties
);

Die Parameter

[out] pVolumeProperties

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

Rückgabewert

Diese Methode kann HRESULT-Standardwerte wie E_INVALIDARG oder E_OUTOFMEMORY und VDS-spezifische Rückgabewerte zurückgeben. Sie kann auch konvertierte Systemfehlercodes mithilfe des HRESULT_FROM_WIN32 Makros zurückgeben. Fehler können von VDS selbst oder vom zugrunde liegenden VDS-Anbieter stammen, der verwendet wird. Mögliche Rückgabewerte sind:

Zurückgeben von Code/Wert Description
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 des Entfernens von Geräten.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows Vista [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2003 [Nur Desktop-Apps]
Zielplattform Fenster
Header vds.h
Library Uuid.lib

Siehe auch

IVdsVolume

VDS_VOLUME_PROP