SetAttributes-Methode der MSFT_Partition-Klasse
Legt verschiedene Attribute und Eigenschaften der Partition fest.
Syntax
UInt32 SetAttributes(
[in] Boolean IsReadOnly,
[in] Boolean NoDefaultDriveLetter,
[in] Boolean IsActive,
[in] Boolean IsHidden,
[out] String ExtendedStatus
);
Parameter
IsReadOnly [in]
Bei TRUE wird die Partition schreibgeschützt. Bei FALSE wird die Partition beschreibbar gemacht.
NoDefaultDriveLetter [in]
Bei TRUE weist das Betriebssystem beim Ermitteln der Partition keinen Laufwerkbuchstaben automatisch zu. Dies gilt nur für GPT-Datenträger und wird für MBR-Datenträger als FALSE angenommen. Dieses Attribut ist in SAN-Umgebungen (Storage Area Network) hilfreich.
IsActive [in]
TRUE , wenn es sich bei der Partition um eine aktive MBR-Partition handelt, die zum Starten des Systems verwendet werden kann. Dieser Parameter ist nur für MBR-Datenträger relevant.
IsHidden [in]
TRUE , wenn die Partition vom Bereitstellungs-Manager nicht erkannt wird. Daher empfängt die Partition keinen Laufwerkbuchstaben, keinen Volume-GUID-Pfad, hostet keine Volumeeinbindungspunkte und wird nicht durch Aufrufe von FindFirstVolume und FindNextVolume aufgelistet. Dadurch wird sichergestellt, dass Anwendungen wie die Datenträgerdefragmentierung nicht auf die Partition zugreifen können. Der Volume Shadow Copy Service (VSS) verwendet dieses Attribut für seine Schattenkopien.
ExtendedStatus [out]
Eine Zeichenfolge, die ein eingebettetes MSFT_StorageExtendedStatus -Objekt enthält.
Mit diesem Parameter kann der Speicheranbieter erweiterte (implementierungsspezifische) Fehlerinformationen zurückgeben.
Rückgabewert
Erfolg (0)
Nicht unterstützt (1)
Nicht angegebener Fehler (2)
Timeout (3)
Fehler (4)
Ungültiger Parameter (5)
In Verwendung (6)
Zugriff verweigert (40001)
Es sind nicht genügend Ressourcen vorhanden, um den Vorgang abzuschließen. (40002)
Cache veraltet (40003)
Der Datenträger wurde nicht initialisiert. (41000)
Der Datenträger ist offline. (41003)
Ein Parameter ist für diesen Partitionstyp ungültig. (41006)
Der Vorgang ist auf einer System- oder kritischen Partition nicht zulässig. (42010)
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Namespace | Stamm\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |