CIM_LogicalFile クラスの CompressEx メソッド
CompressEx メソッドは、オブジェクト パスで指定された論理ファイル (またはディレクトリ) を圧縮します。 このメソッドは、 Compress メソッドの拡張バージョンです。
重要
DMTF (分散管理タスク フォース) CIM (共通情報モデル) クラスは、WMI クラスが構築される親クラスです。 WMI では現在、 CIM 2.x バージョン スキーマのみがサポートされています。
このトピックでは、マネージド オブジェクト形式 (MOF) 構文を使用します。 このメソッドの使用方法の詳細については、「メソッドの 呼び出し」を参照してください。
構文
uint32 CompressEx(
[out] string StopFileName,
[in, optional] string StartFileName,
[in, optional] boolean Recursive
);
パラメーター
-
StopFileName [out]
-
メソッドが失敗したファイル (またはディレクトリ) の名前。 メソッドが成功した場合、このパラメーターは null です。
-
StartFileName [in, optional]
-
メソッドの開始点として使用する子ファイル (またはディレクトリ)。 通常、このパラメーターは、前のメソッド呼び出しからエラーが発生したファイルまたはディレクトリを指定する StopFileName パラメーターです。 このパラメーターが null の場合、 ExecMethod 呼び出しで指定されたファイル (またはディレクトリ) に対して操作が実行されます。
-
Recursive [in, optional]
-
TRUE の場合、メソッドは、CIM_LogicalFile インスタンスによって指定されたディレクトリ内のファイルとディレクトリにも再帰的に適用されます。 ファイル インスタンスの場合、このパラメーターは無視されます。
戻り値
成功した場合は 0 (ゼロ) の値を返し、エラーを示すその他の数値を返します。
-
Success
-
0
正常終了しました。
-
アクセスが拒否されました
-
2
アクセスが拒否されました。
-
不特定のエラー
-
8
指定されていないエラー。
-
無効なオブジェクト
-
9
オブジェクトが無効です。
-
オブジェクトは既に存在します
-
10
オブジェクトは既にあります。
-
ファイル システムが NTFS ではない
-
11
ファイル システムは NTFS ではありません。
-
NT/Windows 2000 以外のプラットフォーム
-
12
プラットフォームは Windows ではありません。
-
ドライブが同じではない
-
13
ドライブが同じではありません。
-
ディレクトリが空ではない
-
14
ディレクトリは空ではありません。
-
共有違反
-
15
共有違反です。
-
開始ファイルが無効です
-
16
開始ファイルが無効です。
-
特権が保持されていません
-
17
特権が保持されていません。
-
パラメーターが無効です
-
21
無効なパラメーター。
解説
このメソッドは現在、WMI では実装されていません。 このメソッドを使用するには、独自のプロバイダーに実装する必要があります。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008 |
| 名前空間 |
Root\CIMV2 |
| MOF |
|
| [DLL] |
|