Win32_Directory クラスの CompressEx メソッド

CompressExWMI クラス メソッドは、オブジェクト パスで指定された論理ディレクトリ エントリ ファイル (またはディレクトリ) を圧縮します (このメソッドは Compress メソッドの拡張バージョンです)。

このトピックでは、マネージド オブジェクト形式 (MOF) 構文を使用します。 このメソッドの使用方法の詳細については、「メソッドの 呼び出し」を参照してください。

構文

uint32 CompressEx(
  [out]          string  StopFileName,
  [in, optional] string  StartFileName,
  [in, optional] boolean Recursive
);

パラメーター

StopFileName [out]

CompressEx メソッドが失敗したファイルまたはディレクトリの名前。 メソッドが成功した場合、このパラメーターは NULL になります。

StartFileName [in, optional]

CompressEx の開始点として使用する子ファイルまたはディレクトリに名前を 付けます。 StartFileName パラメーターは、通常、前のメソッド呼び出しからエラーが発生したファイルまたはディレクトリを指定する StopFileName パラメーターです。 このパラメーターが NULL の場合、 ExecMethod 呼び出しで指定されたファイルまたはディレクトリに対して操作が実行されます。

StartFileName を使用する場合は、Recursive も true に設定する必要があります。

Recursive [in, optional]

true の場合、所有権の変更は、CIM_LogicalFile インスタンスによって指定されたディレクトリ内のファイルとディレクトリに再帰的に適用されます。

Note

ファイル インスタンスの場合、 Recursive 入力パラメーターは無視されます。

戻り値

ファイルが正常に圧縮された場合は 0 (ゼロ) の値を返し、エラーを示すその他の数値を返します。

0

要求は成功しました。

2

アクセスが拒否されました。

8

未指定のエラーが発生しました。

9

指定された名前が無効でした。

"10"

指定されたオブジェクトは既に存在します。

11

ファイル システムは NTFS ではありません。

12

プラットフォームは Windows ではありません。

13

ドライブは同じではありません。

14

ディレクトリが空ではありません。

15

共有違反が発生しました。

16

指定された開始ファイルが無効でした。

17

操作に必要な特権は保持されません。

21

指定されたパラメーターが無効です。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
名前空間	Root\CIMV2
MOF	CIMWin32.mof
[DLL]	CIMWin32.dll

関連項目

オペレーティング システム クラス

Win32_Directory