Win32_ShortcutFile クラスの 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 呼び出しで指定されたファイルまたはディレクトリに対して操作が実行されます。
-
Recursive [in, optional]
-
true の場合、所有権の変更は、CIM_LogicalFile インスタンスによって指定されたディレクトリ内のファイルとディレクトリに再帰的に適用されます。
注意
ファイル インスタンスの場合、 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 |
|
[DLL] |
|