GetSupportedSize-Methode der MSFT_StoragePool-Klasse
Ruft die unterstützten virtuellen Datenträgergrößen ab, die im Speicherpool erstellt werden können.
Diese Größen können auf eine oder beide der folgenden Arten zurückgegeben werden:
- Als Array aller unterstützten Größen im Parameter SupportedSizes .
- Als Bereich, der durch die Parameter VirtualDiskSizeMin, VirtualDiskSizeMax und VirtualDiskSizeDivisor definiert wird.
Syntax
UInt32 GetSupportedSize(
[in] String ResiliencySettingName,
[out] UInt64 SupportedSizes[],
[out] UInt64 VirtualDiskSizeMin,
[out] UInt64 VirtualDiskSizeMax,
[out] UInt64 VirtualDiskSizeDivisor,
[out] String ExtendedStatus
);
Parameter
ResiliencySettingName [in]
Der Name der Resilienzeinstellung, die beim Bestimmen der unterstützten Größen verwendet werden soll. Beachten Sie, dass die zurückgegebenen Größen je nach Resilienzeinstellung unterschiedlich sein können.
SupportedSizes [out]
Ein Array aller unterstützten Größen in Bytes, die vom Speicherpool unterstützt werden. Dieser Parameter kann NULL sein, wenn die Anzahl der unterstützten Größen groß ist, ist aber für Speicherpools nützlich, die nur eine ausgewählte Anzahl von Virtuellen Datenträgergrößen unterstützen.
VirtualDiskSizeMin [out]
Die Mindestgröße des virtuellen Datenträgers in Byte für einen virtuellen Datenträger, der im Speicherpool erstellt wurde.
VirtualDiskSizeMax [out]
Die maximale Größe des virtuellen Datenträgers in Bytes für einen virtuellen Datenträger, der im Speicherpool erstellt wurde.
VirtualDiskSizeDivisor [out]
Gibt den Multiplikator an, der verwendet werden muss, um die Größe eines virtuellen Datenträgers zu bestimmen. Jede in einem Erstellungs- oder Änderungsvorgang angegebene Größe muss ein Vielfaches dieses Werts sein.
Beispiel: Wenn die unterstützte Mindestgröße 10 GB beträgt und dieser Parameter 2 GB beträgt, beträgt die unterstützte Größe für diesen Pool 10 GB, 12 GB, 14 GB usw., bis die maximal unterstützte Größe erreicht ist.
ExtendedStatus [out]
Eine Zeichenfolge, die ein eingebettetes MSFT_StorageExtendedStatus -Objekt enthält.
Dieser Parameter ermöglicht es dem Speicheranbieter, erweiterte (implementierungsspezifische) Fehlerinformationen zurückzugeben.
Rückgabewert
Erfolg (0)
Nicht unterstützt (1)
Nicht angegebener Fehler (2)
Timeout (3)
Fehler (4)
Ungültiger Parameter (5)
Zugriff verweigert (40001)
Es sind nicht genügend Ressourcen vorhanden, um den Vorgang abzuschließen. (40002)
Veralteter Cache (40003)
Es kann keine Verbindung mit dem Speicheranbieter hergestellt werden. (46000)
Der Speicheranbieter kann keine Verbindung mit dem Speichersubsystem herstellen. (46001)
Hinweise
Die von dieser Methode zurückgegebenen Werte sollten den aktuellen Zustand des Speicherpools und dessen verfügbare Speicherkapazität widerspiegeln. Alle in SupportedSizes zurückgegebenen Werte müssen ein Vielfaches von VirtualDiskSizeDivisor sein.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Namespace | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |