Freigeben über


IVdsVolume2::GetProperties2-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 Eigenschaftsinformationen für das aktuelle Volume zurück. Diese Methode ist identisch mit der IVdsVolume::GetProperties-Methode , mit der Ausnahme, dass sie eine VDS_VOLUME_PROP2 Struktur anstelle einer VDS_VOLUME_PROP Struktur zurückgibt.

Syntax

HRESULT GetProperties2(
  [out] VDS_VOLUME_PROP2 *pVolumeProperties
);

Die Parameter

[out] pVolumeProperties

Die Adresse der vom Aufrufer zugewiesenen VDS_VOLUME_PROP2 Struktur. 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.

Bemerkungen

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
Mindestens unterstützter Client Windows 7 [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Fenster
Header vds.h
Library Uuid.lib

Siehe auch

IVdsVolume2