Метод CompressEx класса Win32_Directory
Метод класса CompressExWMI сжимает файл записи логического каталога (или каталог), указанный в пути к объекту (этот метод является расширенной версией метода Compress ).
В этом разделе используется синтаксис MOF. Дополнительные сведения об использовании этого метода см. в разделе Вызов метода .
Синтаксис
uint32 CompressEx(
[out] string StopFileName,
[in, optional] string StartFileName,
[in, optional] boolean Recursive
);
Параметры
-
StopFileName [out]
-
Имя файла или каталога, в котором произошел сбой метода CompressEx . Этот параметр будет иметь значение NULL , если метод будет выполнен успешно.
-
StartFileName [in, необязательный]
-
Присваивает имя дочернему файлу или каталогу для использования в качестве отправной точки для CompressEx. Параметр StartFileName обычно является параметром StopFileName , указывающим файл или каталог, в котором произошла ошибка при предыдущем вызове метода. Если этот параметр имеет значение NULL, операция выполняется с файлом или каталогом, указанным в вызове ExecMethod .
Если используется Параметр StartFileName , для параметра Recursive также должно быть задано значение true.
-
Рекурсивный [in, необязательный]
-
Если значение равно true, изменение владельца будет рекурсивно применено к файлам и каталогам в каталоге, указанном экземпляром CIM_LogicalFile .
Примечание
Для экземпляров файлов параметр рекурсивных входных данных игнорируется.
Возвращаемое значение
Возвращает значение 0 (ноль), если файл был успешно сжат, и любое другое число, указывающее на ошибку.
-
0
-
Запрос выполнен успешно.
-
2
-
В доступе было отказано.
-
8
-
Произошла неуказаная ошибка.
-
9
-
Указанное имя было недопустимым.
-
10
-
Указанный объект уже существует.
-
11
-
Файловая система не является NTFS.
-
12
-
Платформа не является Windows.
-
13
-
Диск отличается.
-
14
-
Каталог не пуст.
-
15
-
Произошло нарушение общего доступа.
-
16
-
Указан недопустимый начальный файл.
-
17
-
Привилегия, необходимая для операции, не удерживается.
-
21
-
Указанный параметр недопустим.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента |
Windows Vista |
Минимальная версия сервера |
Windows Server 2008 |
Пространство имен |
Root\CIMV2 |
MOF |
|
DLL |
|