SetFriendlyName-Methode der MSFT_VirtualDisk-Klasse
Benennt den virtuellen Datenträger um.
Syntax
UInt32 SetFriendlyName(
[in] String FriendlyName,
[out] String ExtendedStatus
);
Parameter
FriendlyName [in]
Der neue Anzeigename, der für den virtuellen Datenträger festgelegt werden soll.
Dieser Parameter ist erforderlich und darf nicht NULL sein.
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)
Zugriff verweigert (40001)
Es sind nicht genügend Ressourcen vorhanden, um den Vorgang abzuschließen. (40002)
Es kann keine Verbindung mit dem Speicheranbieter hergestellt werden. (46000)
Der Speicheranbieter kann keine Verbindung mit dem Speichersubsystem herstellen. (46001)
Der Speicherpool konnte den Vorgang nicht abschließen, da seine Integrität oder betriebliche status dies nicht zulässt. (48006)
Der Speicherpool konnte den Vorgang nicht abschließen, da seine Konfiguration schreibgeschützt ist. (48007)
Der virtuelle Datenträger konnte den Vorgang nicht abschließen, da ein anderer Computer seine Konfiguration steuert. (50002)
Der virtuelle Datenträger konnte den Vorgang nicht abschließen, da seine Integritäts- oder betriebsbezogene status dies nicht zulässt. (50003)
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 |