IVdsDisk3::GetProperties2-Methode (vds.h)
[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API ersetzt.]
Gibt Eigenschafteninformationen für einen Datenträger zurück. Diese Methode ist identisch mit der IVdsDisk::GetProperties-Methode , mit der Ausnahme, dass sie eine VDS_DISK_PROP2-Struktur anstelle einer VDS_DISK_PROP-Struktur zurückgibt.
Syntax
HRESULT GetProperties2(
[out] VDS_DISK_PROP2 *pDiskProperties
);
Parameter
[out] pDiskProperties
Die Adresse der VDS_DISK_PROP2 Struktur, die vom Aufrufer zugewiesen und übergeben wird. VDS weist Arbeitsspeicher für die Memberzeichenfolgen pwszDiskAddress, pwszName, pwszFriendlyName, pwszAdaptorName, pwszDevicePath und pwszLocationPath zu. Aufrufer müssen die Zeichenfolgen 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. Es kann auch konvertierte Systemfehlercodes mithilfe des HRESULT_FROM_WIN32-Makros 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 |
|---|---|
|
Die Eigenschaften wurden erfolgreich zurückgegeben. |
|
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 des Geräts. |
Bemerkungen
In der VDS_DISK_PROP2-Struktur , die im pDiskProperties-Parameter zurückgegeben wird, ist der pwszDiskAddress-Member optional und kann NULL sein, wenn kein Wert verfügbar ist. Aufrufer dieser Methode müssen überprüfen, ob dieser Member NULL ist.
Für Hyper-V ist der pwszLocationPath-MemberNULL, da der virtuelle Controller den Speicherortpfad nicht zurückgibt.
Anforderungen
| 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 |