Método CreateVolume da classe MSFT_StoragePool
Cria um disco virtual e um único volume usando os recursos do pool de armazenamento.
Sintaxe
UInt32 CreateVolume(
[in] String FriendlyName,
[in] UInt64 Size,
[in] String StorageTiers[],
[in] UInt64 StorageTierSizes[],
[in] UInt16 ProvisioningType,
[in] String ResiliencySettingName,
[in] UInt16 PhysicalDiskRedundancy,
[in] UInt16 NumberOfColumns,
[in] UInt16 FileSystem,
[in] String AccessPath,
[in] String FileServer,
[out] String CreatedVolume,
[out] MSFT_StorageJob REF CreatedStorageJob,
[out] String ExtendedStatus
);
Parâmetros
FriendlyName [in]
O nome amigável do volume. O nome amigável deve descrever o volume. Não precisa ser exclusivo. O rótulo do sistema de arquivos também será definido como esse nome.
Esse parâmetro é necessário e não pode ser NULL.
Tamanho [in]
O tamanho do disco virtual. Observe que alguns subsistemas de armazenamento arredondarão o tamanho para cima ou para baixo para um múltiplo de seu tamanho de unidade de alocação. O tamanho do volume criado será tão grande quanto esse tamanho de disco virtual permitir.
StorageTiers [in]
As camadas de armazenamento no disco virtual. Cada elemento de matriz é um objeto MSFT_StorageTier .
StorageTierSizes [in]
Os tamanhos das camadas.
ProvisioningType [in]
O tipo de provisionamento do volume.
| Valor | Significado |
|---|---|
| 1 | Provisionamento fino – o armazenamento para o volume é alocado sob demanda. |
| 2 | Provisionamento fixo – o armazenamento para o volume é alocado quando o volume é criado. |
ResiliencySettingName [in]
O nome da configuração de resiliência a ser usada como modelo para esse volume. É o mesmo que a propriedade Name da instância de configuração de resiliência. Somente as configurações de resiliência associadas a esse pool de armazenamento podem ser usadas.
PhysicalDiskRedundancy [in]
O número de falhas de disco físicas que o disco virtual pode suportar sem perda de dados. Se não for especificado, o valor usado será o membro PhysicalDiskRedundancyDefault da configuração de resiliência especificada por ResiliencySettingName.
NumberOfColumns [in]
O número de discos físicos a serem usados para distribuir os dados. Se não for especificado, o valor usado será o membro NumberOfColumnsDefault da configuração de resiliência especificada por ResiliencySettingName.
FileSystem [in]
O tipo de sistema de arquivos a ser usado no volume criado. Um sistema de arquivos CSV só tem suporte em um subsistema de espaços de armazenamento. Para CSV, o pool deve ser clusterizável e o volume criado será um volume compartilhado de cluster.
Esse parâmetro é necessário e não pode ser NULL.
| Valor | Significado |
|---|---|
| 14 | NTFS |
| 15 | ReFS |
| 0x8000 | CSVFS_NTFS |
| 0x8001 | CSVFS_ReFS |
AccessPath [in]
Um caminho de acesso local para o volume. Se o caminho de acesso não puder ser definido ou esse parâmetro for NULL, um novo caminho de acesso será atribuído.
FileServer [in]
Começando em Windows 10: uma cadeia de caracteres que contém um objeto MSFT_FileServer inserido, representando o servidor de arquivos que será o proprietário desse volume.
CreatedVolume [out]
O volume criado, um objeto MSFT_Volume .
CreatedStorageJob [out]
Retorna uma referência ao objeto de trabalho de armazenamento usado para acompanhar a operação de execução prolongada.
ExtendedStatus [out]
Informações de erro estendidas em um objeto MSFT_StorageExtendedStatus . As informações são específicas da implementação.
Retornar valor
Sucesso (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)
Tamanho sem suporte (4097)
Espaço livre insuficiente (40000)
Acesso negado (40001)
Não há recursos suficientes para concluir a operação. (40002)
Ocorreu um erro inesperado de E/S. (40004)
Você deve especificar um tamanho usando o parâmetro Size ou UseMaximumSize . Você pode especificar apenas um desses parâmetros por vez. (40005)
O caminho de acesso solicitado já está em uso. (42002)
O caminho de acesso não é válido. (42007)
Não há suporte para o sistema de arquivos especificado. (43001)
O volume não pode ser formatado rapidamente. (43002)
Não é possível executar a operação solicitada quando a unidade é somente leitura. (43006)
Você deve especificar um nome para esse volume. (43017)
Você deve especificar um servidor de arquivos ao qual expor esse volume. (43018)
O volume não é exposto ao servidor de arquivos especificado. (43019)
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 habilitar clustering de failover para esse objeto de armazenamento. (46008)
Não há suporte para essa operação em pools de armazenamento primordiais. (48000)
O pool de armazenamento é reservado apenas para uso especial. (48001)
Não há suporte para a configuração de resiliência especificada por esse pool de armazenamento. (48002)
Não há discos físicos suficientes no pool de armazenamento para criar a configuração de disco virtual especificada. (48004)
O pool de armazenamento não pôde concluir a operação porque sua integridade ou status operacional não a permite. (48006)
O pool de armazenamento não pôde concluir a operação porque sua configuração é somente leitura. (48007)
Você deve especificar as informações de tamanho (o parâmetro Size ou UseMaximumSize ) ou as informações de camada (os parâmetros StorageTiers e StorageTierSizes ), mas não informações de tamanho e camada. (48010)
Não existe nenhuma configuração de resiliência com esse nome. (49000)
Não há suporte para o valor de NoSinglePointOfFailure . (49001)
O valor de PhysicalDiskRedundancy está fora do intervalo de valores com suporte. (49002)
O valor de NumberOfDataCopies está fora do intervalo de valores com suporte. (49003)
O valor de ParityLayout está fora do intervalo de valores com suporte. (49004)
O valor de Interleave está fora do intervalo de valores com suporte. (49005)
O valor de NumberOfColumns está fora do intervalo de valores com suporte. (49006)
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8.1 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 R2 [somente aplicativos da área de trabalho] |
| Namespace | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |