CreateMaskingSet-Methode der MSFT_StorageSubSystem-Klasse
Erstellt einen neuen Maskierungssatz.
Ein Maskierungssatz ist eine logische Gruppierung von virtuellen Datenträgern, Zielports und Initiatoren zum Anzeigen virtueller Datenträger für Hostcomputer
Syntax
UInt32 CreateMaskingSet(
[in] String FriendlyName,
[in] String VirtualDiskNames[],
[in] UInt16 DeviceAccesses[],
[in] String DeviceNumbers[],
[in] String TargetPortAddresses[],
[in] String InitiatorAddresses[],
[in] UInt16 HostType,
[in] Boolean RunAsJob,
[out] MSFT_StorageJob REF CreatedStorageJob,
[out] String CreatedMaskingSet,
[out] String ExtendedStatus
);
Parameter
FriendlyName [in]
Der Anzeigename für den Maskierungssatz.
Anzeigenamen sollen beschreibend sein, müssen aber nicht eindeutig sein.
Dieser Parameter ist erforderlich und darf nicht NULL sein.
VirtualDiskNames [in]
Die Liste der virtuellen Datenträger, die den Initiatoren im Maskierungssatz angezeigt werden sollen. Jeder Datenträger muss durch den Bezeichner angegeben werden, der in der Name-Eigenschaft seines MSFT_VirtualDisk-Objekts gespeichert ist.
Dieser Parameter verfügt über eine 1:1-Zuordnung mit dem DeviceAccesses-Parameter . Beide Arrays müssen die gleiche Länge aufweisen, und die Elemente müssen in derselben Reihenfolge angeordnet sein.
DeviceAccesses [in]
Die Zugriffsebene, die der Initiator auf jeden virtuellen Datenträger haben soll, der im VirtualDiskNames-Parameter angegeben ist. Dieser Parameter verfügt über eine 1:1-Zuordnung mit dem Parameter VirtualDiskNames . Beide Arrays müssen die gleiche Länge aufweisen, und die Elemente müssen in derselben Reihenfolge angeordnet sein.
Unbekannt (0)
Schreibzugriff (2)
Schreibgeschützt (3)
Kein Zugriff (4)
DeviceNumbers [in]
Gibt die Reihenfolge an, in der die virtuellen Datenträger initiatoren angezeigt werden sollen. Diese Funktion ist nur verfügbar, wenn die MaskingClientSelectableDeviceNumbers-Eigenschaft des Speichersubsystems TRUE ist. Wenn angegeben, muss dieser Parameter eine 1:1-Zuordnung mit dem Parameter VirtualDiskNames aufweisen.
TargetPortAddresses [in]
Die Zielports, die beim Anzeigen der virtuellen Datenträger für Initiatoren verwendet werden sollen. Die Anzahl der Zielports, die angegeben werden können, hängt von der MaskingPortsPerView-Eigenschaft des Subsystems ab. Wenn MaskingPortsPerViewfür Alle Zielports dieselbe Ansicht ist, wird dieser Parameter ignoriert, und alle Zielports im System sind diesem Maskierungssatz zugeordnet.
InitiatorAddresses [in]
Die Initiatoren, denen die virtuellen Datenträger angezeigt werden sollen. Wenn die MaskingOneInitiatorIdPerView-Eigenschaft des Subsystems TRUE ist, kann nur ein Initiator für diesen Maskierungssatz angegeben werden. Die Liste der gültigen Initiatoradressenformate wird durch die MaskingValidInitiatorIdTypes-Eigenschaft des Subsystems angegeben.
HostType [in]
Das Hostbetriebssystem oder andere Umgebungsfaktoren des Hosts, die das Verhalten des Speichersystems beim Anzeigen eines virtuellen Datenträgers für einen Initiator beeinflussen können.
Werte zwischen 22 und 32767 (einschließlich) sind für DMTF reserviert. Werte zwischen 32768 und 65535 (einschließlich) sind für Anbieter reserviert.
Unbekannt (0)
Sonstiges (1)
Standard (2)
Solaris (3)
HPUX (4)
OpenVMS (5)
Tru64 (6)
Netware (7)
Fortsetzung (8)
AIX (9)
DGUX (10)
Dynix (11)
Irix (12)
Cisco iSCSI Storage Router (13)
Linux (14)
Microsoft Windows (15)
OS400 (16)
TRESPASS (17)
HI-UX (18)
VMware ESXi (19)
Microsoft Windows Server 2008 (20)
Microsoft Windows Server 2003 (21)
DMTF Reserviert (22..32767)
Herstellerspezifisch (32768..65535)
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.
CreatedMaskingSet [out]
Wenn der Maskierungssatz erfolgreich erstellt wurde, empfängt dieser Parameter eine Zeichenfolge, die ein eingebettetes MSFT_MaskingSet -Objekt enthält.
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)
Es kann keine Verbindung mit dem Speicheranbieter hergestellt werden. (46000)
Der Speicheranbieter kann keine Verbindung mit dem Speichersubsystem herstellen. (46001)
Der angegebene virtuelle Datenträger konnte nicht gefunden werden. (50000)
Die angegebene Gerätenummer ist ungültig. (52000)
Der angeforderte HostType wird nicht unterstützt. (52001)
DeviceAccess muss für jeden virtuellen Datenträger angegeben werden. (52002)
Die angegebene Initiatoradresse ist ungültig (53000)
Für diesen Vorgang ist nur eine Initiatoradresse zulässig. (53001)
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 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |