Metodo CreateMaskingSet della classe MSFT_StorageSubSystem
Crea un nuovo set di mascheramento.
Un set di maschera è un raggruppamento logico di dischi virtuali, porte di destinazione e iniziatori allo scopo di visualizzare i dischi virtuali per ospitare i computer
Sintassi
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
);
Parametri
FriendlyName [in]
Nome descrittivo del set di maschere.
I nomi descrittivi devono essere descrittivi, ma non devono essere univoci.
Questo parametro è obbligatorio e non può essere NULL.
VirtualDiskNames [in]
Elenco di dischi virtuali da visualizzare agli iniziatori nel set di mascheramento. Ogni disco deve essere specificato dall'identificatore archiviato nella proprietà Name del relativo oggetto MSFT_VirtualDisk
Questo parametro ha un mapping 1:1 con il parametro DeviceAccesses . Entrambe le matrici devono avere la stessa lunghezza e gli elementi devono essere disposti nello stesso ordine.
DeviceAccesses [in]
Livello di accesso che l'iniziatore deve avere per ogni disco virtuale specificato nel parametro VirtualDiskNames . Questo parametro ha un mapping 1:1 con il parametro VirtualDiskNames . Entrambe le matrici devono avere la stessa lunghezza e gli elementi devono essere disposti nello stesso ordine.
Sconosciuto (0)
Lettura scrittura (2)
Sola lettura (3)
Nessun accesso (4)
DeviceNumbers [in]
Specifica l'ordine in cui devono essere visualizzati i dischi virtuali agli iniziatori. Questa funzionalità è disponibile solo se la proprietà MaskingClientSelectableDeviceNumbers del sottosistema di archiviazione è TRUE. Se specificato, questo parametro deve avere un mapping 1:1 con il parametro VirtualDiskNames .
TargetPortAddresses [in]
Porte di destinazione da usare quando vengono visualizzati i dischi virtuali agli iniziatori. Il numero di porte di destinazione che è possibile specificare dipende dalla proprietà MaskingPortsPerView del sottosistema. Se MaskingPortsPerView è Tutte le porte di destinazione condividono la stessa visualizzazione, questo parametro viene ignorato e tutte le porte di destinazione nel sistema sono associate a questo set di mascheramento.
IniziatoreAddresses [in]
Iniziatori a cui devono essere visualizzati i dischi virtuali. Se la proprietà MaskingOneInitiatorIdPerView del sottosistema è TRUE, per questo set di maschera è possibile specificare un solo iniziatore. L'elenco dei formati di indirizzi iniziatori validi viene specificato dalla proprietà MaskingValidInitiatorIdTypes del sottosistema.
HostType [in]
Il sistema operativo host o altri fattori ambientali host che possono influenzare il comportamento che il sistema di archiviazione deve avere quando mostra un disco virtuale a un iniziatore.
I valori compresi tra 22 e 32767 (inclusi) sono riservati per DMTF. I valori compresi tra 32768 e 65535 (inclusi) sono riservati ai fornitori.
Sconosciuto (0)
Altro (1)
Standard (2)
Solaris (3)
HPUX (4)
OpenVMS (5)
Tru64 (6)
Netware (7)
Sequent (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 Riservato (22..32767)
Specifica del fornitore (32768..65535)
RunAsJob [in]
Se TRUE, questo metodo usa il parametro CreatedStorageJob quando la richiesta richiede molto tempo al servizio. Se è stato creato un processo di archiviazione per tenere traccia dell'operazione, questo metodo restituirà i parametri del metodo checked - Job Started.
Nota
Anche se RunAsJob è TRUE, questo metodo può comunque restituire un risultato se è terminato in tempo sufficiente.
Se FALSE o NULL, questo metodo seguirà il comportamento asincrono WMI predefinito determinato dal metodo del client per la chiamata. In altre parole, è sincrono, a meno che non venga richiesto diversamente.
CreatedStorageJob [out]
Se RunAsJob è impostato su TRUE e l'esecuzione di questo metodo richiede molto tempo, questo parametro riceve un riferimento all'oggetto processo di archiviazione utilizzato per tenere traccia dell'operazione a esecuzione prolungata.
CreatedMaskingSet [out]
Se il set di maschera viene creato correttamente, questo parametro riceve una stringa contenente un oggetto MSFT_MaskingSet incorporato.
ExtendedStatus [out]
Stringa contenente un oggetto MSFT_StorageExtendedStatus incorporato.
Questo parametro consente al provider di archiviazione di restituire informazioni di errore estese (specifiche dell'implementazione).
Valore restituito
Operazione riuscita (0)
Non supportato (1)
Errore non specificato (2)
Timeout (3)
Non riuscito (4)
Parametro non valido (5)
Parametri del metodo controllati - Processo avviato (4096)
Accesso negato (40001)
Non sono disponibili risorse sufficienti per completare l'operazione. (40002)
Impossibile connettersi al provider di archiviazione. (46000)
Il provider di archiviazione non può connettersi al sottosistema di archiviazione. (46001)
Impossibile trovare il disco virtuale specificato. (50000)
Il numero di dispositivo specificato non è valido. (52000)
HostType richiesto non è supportato. (52001)
DeviceAccess deve essere specificato per ogni disco virtuale. (52002)
L'indirizzo iniziatore specificato non è valido (53000)
Per questa operazione è accettabile un solo indirizzo iniziatore. (53001)
L'indirizzo della porta di destinazione specificato non è valido. (54000)
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 [solo app desktop] |
| Spazio dei nomi | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |