Hide-Methode der MSFT_VirtualDisk-Klasse
Blendet einen virtuellen Datenträger vor einem Initiator aus.
Dieser Vorgang wird auch als "Entlichten" oder "Maskieren" eines virtuellen Datenträgers bezeichnet.
Syntax
UInt32 Hide(
[in] String TargetPortAddresses[],
[in] String InitiatorAddress,
[in] Boolean RunAsJob,
[out] MSFT_StorageJob REF CreatedStorageJob,
[out] String ExtendedStatus
);
Parameter
TargetPortAddresses [in]
Ein Array von Zielportadressen, für das der virtuelle Datenträger ausgeblendet werden soll. Hinweis: Dieses Array kann eine Teilmenge der Adressen enthalten, die ursprünglich in der Show-Methode angegeben wurden.
Dieser Parameter ist erforderlich und darf nicht NULL sein.
InitiatorAddress [in]
Die Adresse des Initiators, von dem der virtuelle Datenträger ausgeblendet werden soll.
Dieser Parameter ist erforderlich und darf nicht NULL sein.
RunAsJob [in]
Bei TRUE verwendet diese Methode den Parameter CreatedStorageJob , wenn die Anforderung lange dauert. Wenn ein Speicherauftrag zum Nachverfolgen des Vorgangs erstellt wurde, gibt diese Methode Methodenparameter Überprüft – Auftrag gestartet zurück.
Hinweis
Selbst wenn RunAsJobTRUE ist, kann diese Methode trotzdem ein Ergebnis zurückgeben, wenn sie in ausreichender Zeit abgeschlossen ist.
Wenn FALSE oder NULL, folgt diese Methode dem standardmäßigen asynchronen WMI-Verhalten, das von der Clientmethode für den Aufruf bestimmt wird. Mit anderen Worten, es ist synchron, sofern nicht anders angefordert.
CreatedStorageJob [out]
Wenn RunAsJob auf TRUE festgelegt ist und die Ausführung dieser Methode sehr lange dauert, empfängt dieser Parameter einen Verweis auf das Speicherauftragsobjekt, das zum Nachverfolgen des lang andauernden Vorgangs verwendet wird.
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)
Methodenparameter überprüft – Auftrag gestartet (4096)
Zugriff verweigert (40001)
Es sind nicht genügend Ressourcen vorhanden, um den Vorgang abzuschließen. (40002)
Cache veraltet (40003)
Es kann keine Verbindung mit dem Speicheranbieter hergestellt werden. (46000)
Der Speicheranbieter kann keine Verbindung mit dem Speichersubsystem herstellen. (46001)
Der angeforderte HostType wird nicht unterstützt. (52001)
Die angegebene Initiatoradresse ist ungültig (53000)
Die angegebene Zielportadresse ist ungültig. (54000)
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 |