Método CompressEx da classe CIM_DataFile
O método CompressEx usa a compactação NTFS para compactar o arquivo lógico (ou diretório) especificado no caminho do objeto. Esse método é herdado de CIM_LogicalFile. Esse método é uma versão estendida do método Compress e é herdado de CIM_LogicalFile.
Importante
As classes CIM do DMTF (Distributed Management Task Force) (Common Information Model) são as classes pai nas quais as classes WMI são criadas. Atualmente, o WMI dá suporte apenas aos esquemas de versão cim 2.x.
Este tópico usa a sintaxe MOF (Managed Object Format). Para obter mais informações sobre como usar esse método, consulte Chamando um método.
Sintaxe
uint32 CompressEx(
[out] string StopFileName,
[in] string StartFileName,
[in] boolean Recursive
);
Parâmetros
-
StopFileName [out]
-
Cadeia de caracteres que representa o nome do arquivo (ou diretório) em que o método falhou. Esse parâmetro será nulo se o método for bem-sucedido.
-
StartFileName [in]
-
Cadeia de caracteres que representa o arquivo filho (ou diretório) a ser usado como ponto de partida para esse método. Normalmente, o parâmetro StartFileName é o parâmetro StopFileName que especifica o arquivo ou diretório no qual ocorreu um erro na chamada do método anterior. Se esse parâmetro for nulo, a operação será executada no arquivo ou diretório especificado na chamada ExecMethod .
Se StartFileName for usado, Recursive também deverá ser definido como true.
-
Recursivo [in]
-
Se TRUE, o método também será aplicado recursivamente a arquivos e diretórios dentro do diretório especificado pela instância CIM_DataFile . Para instâncias de arquivo, esse parâmetro é ignorado.
Valor retornado
Retorna um valor de 0 (zero) em caso de êxito e qualquer outro número para indicar um erro. Para obter códigos de erro adicionais, consulte Constantes de erro WMI ou WbemErrorEnum. Para obter valores gerais de HRESULT , consulte Códigos de erro do sistema.
-
0
-
Êxito.
-
2
-
Acesso negado.
-
8
-
Falha não especificada.
-
9
-
Objeto inválido.
-
10
-
O objeto já existe.
-
11
-
Sistema de arquivos não NTFS.
-
12
-
Plataforma não Windows.
-
13
-
A unidade não é a mesma.
-
14
-
O diretório não está vazio.
-
15
-
Violação de compartilhamento.
-
16
-
Arquivo inicial inválido.
-
17
-
Privilégio não mantido.
-
21
-
Parâmetro inválido.
Comentários
O método CompressEx no CIM_DataFile é implementado pelo WMI.
Esta documentação é derivada das descrições da classe CIM publicadas pelo DMTF. A Microsoft pode ter feito alterações para corrigir erros secundários, estar em conformidade com os padrões de documentação do SDK da Microsoft ou fornecer mais informações.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|