Método CreateMaskingSet da classe MSFT_StorageSubSystem
Cria um novo conjunto de mascaramento.
Um conjunto de mascaramento é um agrupamento lógico de discos virtuais, portas de destino e iniciadores com a finalidade de mostrar discos virtuais para hospedar computadores
Sintaxe
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]
O nome amigável para o conjunto de mascaramento.
Espera-se que os nomes amigáveis sejam descritivos, mas não precisam ser exclusivos.
Esse parâmetro é necessário e não pode ser NULL.
VirtualDiskNames [in]
A lista de discos virtuais a serem mostrados aos iniciadores no conjunto de mascaramento. Cada disco deve ser especificado pelo identificador armazenado na propriedade Name de seu objeto MSFT_VirtualDisk
Esse parâmetro tem um mapeamento 1:1 com o parâmetro DeviceAccesses. Ambas as matrizes devem ter o mesmo comprimento e os elementos devem ser organizados na mesma ordem.
DeviceAccesses [in]
O nível de acesso que o iniciador deve ter para cada disco virtual especificado no parâmetro VirtualDiskNames . Esse parâmetro tem um mapeamento 1:1 com o parâmetro VirtualDiskNames . Ambas as matrizes devem ter o mesmo comprimento e os elementos devem ser organizados na mesma ordem.
Desconhecido (0)
Leitura gravação (2)
Somente leitura (3)
Sem acesso (4)
DeviceNumbers [in]
Especifica a ordem na qual os discos virtuais devem ser mostrados aos iniciadores. Essa funcionalidade só estará disponível se a propriedade MaskingClientSelectableDeviceNumbers do subsistema de armazenamento for TRUE. Se especificado, esse parâmetro deve ter um mapeamento 1:1 com o parâmetro VirtualDiskNames .
TargetPortAddresses [in]
As portas de destino a serem usadas ao mostrar os discos virtuais para iniciadores. O número de portas de destino que podem ser especificadas depende da propriedade MaskingPortsPerView do subsistema. Se MaskingPortsPerView for Todas as portas de destino compartilharem a mesma exibição, esse parâmetro será ignorado e todas as portas de destino no sistema serão associadas a esse conjunto de mascaramento.
InitiatorAddresses [in]
Os iniciadores aos quais os discos virtuais devem ser mostrados. Se a propriedade MaskingOneInitiatorIdPerView do subsistema for TRUE, somente um iniciador poderá ser especificado para esse conjunto de mascaramento. A lista de formatos de endereços do iniciador válidos é especificada pela propriedade MaskingValidInitiatorIdTypes do subsistema.
HostType [in]
O sistema operacional do host ou outros fatores ambientais do host que podem influenciar o comportamento que o sistema de armazenamento deve ter ao mostrar um disco virtual para um iniciador.
Valores entre 22 e 32767 (inclusive) são reservados para DMTF. Os valores entre 32768 e 65535 (inclusive) são reservados para fornecedores.
Desconhecido (0)
Outros (1)
Padrão (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)
INVASÃO (17)
HI-UX (18)
VMware ESXi (19)
Microsoft Windows Server 2008 (20)
Microsoft Windows Server 2003 (21)
DMTF Reservado (22..32767)
Específico do fornecedor (32768..65535)
RunAsJob [in]
Se TRUE, esse método usará o parâmetro CreatedStorageJob quando a solicitação estiver demorando muito tempo para ser atendida. Se um trabalho de armazenamento tiver sido criado para acompanhar a operação, esse método retornará Parâmetros de Método Verificados – Trabalho Iniciado.
Observação
Mesmo que RunAsJob seja TRUE, esse método ainda poderá retornar um resultado se tiver terminado em tempo suficiente.
Se FALSE ou NULL, esse método seguirá o comportamento assíncrono WMI padrão, conforme determinado pelo método do cliente para invocação. Em outras palavras, ele é síncrono, a menos que solicitado de outra forma.
CreatedStorageJob [out]
Se RunAsJob for definido como TRUE e esse método levar muito tempo para ser executado, esse parâmetro receberá uma referência ao objeto de trabalho de armazenamento que é usado para acompanhar a operação de execução prolongada.
CreatedMaskingSet [out]
Se o conjunto de mascaramento for criado com êxito, esse parâmetro receberá uma cadeia de caracteres que contém um objeto MSFT_MaskingSet inserido.
ExtendedStatus [out]
Uma cadeia de caracteres que contém um objeto MSFT_StorageExtendedStatus inserido.
Esse parâmetro permite que o provedor de armazenamento retorne informações de erro estendidas (específicas da implementação).
Retornar valor
Êxito (0)
Sem suporte (1)
Erro não especificado (2)
Tempo limite (3)
Falha (4)
Parâmetro inválido (5)
Parâmetros de método verificados – Trabalho iniciado (4096)
Acesso negado (40001)
Não há recursos suficientes para concluir a operação. (40002)
Não é possível se conectar ao provedor de armazenamento. (46000)
O provedor de armazenamento não pode se conectar ao subsistema de armazenamento. (46001)
Não foi possível encontrar o disco virtual especificado. (50000)
O número do dispositivo especificado não é válido. (52000)
Não há suporte para o HostType solicitado. (52001)
DeviceAccess deve ser especificado para cada disco virtual. (52002)
O endereço do iniciador especificado não é válido (53000)
Somente um endereço iniciador é aceitável para esta operação. (53001)
O endereço da porta de destino especificado não é válido. (54000)
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 [somente aplicativos da área de trabalho] |
| Namespace | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |