Método CreateMaskingSet de la clase MSFT_StorageSubSystem
Crea un nuevo conjunto de enmascaramiento.
Un conjunto de enmascaramiento es una agrupación lógica de discos virtuales, puertos de destino e iniciadores para mostrar discos virtuales en equipos host.
Sintaxis
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
);
Parámetros
FriendlyName [in]
Nombre descriptivo del conjunto de enmascaramiento.
Se espera que los nombres descriptivos sean descriptivos, pero no son necesarios para ser únicos.
Este parámetro es obligatorio y no puede ser NULL.
VirtualDiskNames [in]
Lista de discos virtuales que se van a mostrar a los iniciadores en el conjunto de enmascaramiento. Cada disco debe especificarse mediante el identificador almacenado en la propiedad Name de su objeto MSFT_VirtualDisk
Este parámetro tiene una asignación 1:1 con el parámetro DeviceAccesses . Ambas matrices deben tener la misma longitud y los elementos deben organizarse en el mismo orden.
DeviceAccesses [in]
Nivel de acceso que el iniciador debe tener en cada disco virtual especificado en el parámetro VirtualDiskNames . Este parámetro tiene una asignación 1:1 con el parámetro VirtualDiskNames . Ambas matrices deben tener la misma longitud y los elementos deben organizarse en el mismo orden.
Desconocido (0)
Lectura de escritura (2)
Solo lectura (3)
Sin acceso (4)
DeviceNumbers [in]
Especifica el orden en que se deben mostrar los discos virtuales a los iniciadores. Esta funcionalidad solo está disponible si la propiedad MaskingClientSelectableDeviceNumbers del subsistema de almacenamiento es TRUE. Si se especifica, este parámetro debe tener una asignación 1:1 con el parámetro VirtualDiskNames .
TargetPortAddresses [in]
Los puertos de destino que se van a usar al mostrar los discos virtuales a los iniciadores. El número de puertos de destino que se pueden especificar depende de la propiedad MaskingPortsPerView del subsistema. Si MaskingPortsPerView es Todos los puertos de destino comparten la misma vista, este parámetro se omite y todos los puertos de destino del sistema están asociados a este conjunto de enmascaramiento.
InitiatorAddresses [in]
Iniciadores a los que se deben mostrar los discos virtuales. Si la propiedad MaskingOneInitiatorIdPerView del subsistema es TRUE, solo se puede especificar un iniciador para este conjunto de enmascaramiento. La lista de formatos de dirección del iniciador válidos se especifica mediante la propiedad MaskingValidInitiatorIdTypes del subsistema.
HostType [in]
El sistema operativo host u otros factores ambientales de host que pueden influir en el comportamiento que el sistema de almacenamiento debe tener al mostrar un disco virtual a un iniciador.
Los valores entre 22 y 32767 (ambos incluidos) están reservados para DMTF. Los valores entre 32768 y 65535 (ambos incluidos) están reservados para los proveedores.
Desconocido (0)
Otros (1)
Estándar (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 Reservado (22..32767)
Específico del proveedor (32768..65535)
RunAsJob [in]
Si es TRUE, este método usa el parámetro CreatedStorageJob cuando la solicitud tarda mucho tiempo en atenderse. Si se ha creado un trabajo de almacenamiento para realizar un seguimiento de la operación, este método devolverá Parámetros de método activados: trabajo iniciado.
Nota
Incluso si RunAsJob es TRUE, este método todavía puede devolver un resultado si ha terminado en tiempo suficiente.
Si es FALSE o NULL, este método seguirá el comportamiento asincrónico de WMI predeterminado determinado por el método del cliente para la invocación. En otras palabras, es sincrónico a menos que se solicite lo contrario.
CreatedStorageJob [out]
Si RunAsJob se establece en TRUE y este método tarda mucho tiempo en ejecutarse, este parámetro recibe una referencia al objeto de trabajo de almacenamiento que se usa para realizar un seguimiento de la operación de ejecución prolongada.
CreatedMaskingSet [out]
Si el conjunto de enmascaramiento se crea correctamente, este parámetro recibe una cadena que contiene un objeto MSFT_MaskingSet incrustado.
ExtendedStatus [out]
Cadena que contiene un objeto MSFT_StorageExtendedStatus incrustado.
Este parámetro permite al proveedor de almacenamiento devolver información de error extendida (específica de la implementación).
Valor devuelto
Correcto (0)
No compatible (1)
Error no especificado (2)
Tiempo de espera (3)
Error (4)
Parámetro no válido (5)
Parámetros del método activados: trabajo iniciado (4096)
Acceso denegado (40001)
No hay suficientes recursos para completar la operación. (40002)
No se puede conectar al proveedor de almacenamiento. (46000)
El proveedor de almacenamiento no se puede conectar al subsistema de almacenamiento. (46001)
No se encontró el disco virtual especificado. (50000)
El número de dispositivo especificado no es válido. (52000)
No se admite hostType solicitado. (52001)
DeviceAccess debe especificarse para cada disco virtual. (52002)
La dirección del iniciador especificada no es válida (53000)
Solo una dirección del iniciador es aceptable para esta operación. (53001)
La dirección de puerto de destino especificada no es válida. (54000)
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2012 [solo aplicaciones de escritorio] |
| Espacio de nombres | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |