CIM_DeviceFile クラスの CompressEx メソッド

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

重要

DMTF (分散管理タスクフォース) CIM (共通情報モデル) クラスは、WMI クラスが構築される親クラスです。 WMI では現在、 CIM 2.x バージョンスキーマのみがサポートされています。

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

構文

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

StopFileName [out]: メソッドが失敗したファイル (またはディレクトリ) の名前を表す文字列。メソッドが成功した場合、このパラメーターは null です 。
StartFileName [in]: このメソッドの開始点として使用する子ファイル (またはディレクトリ) を表す文字列。通常、 StartFileName パラメーターは、前のメソッド呼び出しでエラーが発生したファイル (またはディレクトリ) を指定する StopFileName パラメーターです。このパラメーターが null の場合、 ExecMethod 呼び出しで指定されたファイル (またはディレクトリ) に対して操作が実行されます。
Recursive [in]: TRUE の場合、メソッドは、CIM_DeviceFile インスタンスによって指定されたディレクトリ内のファイルとディレクトリにも再帰的に適用されます。ファイルインスタンスの場合、このパラメーターは無視されます。

成功した場合は 0 (ゼロ) の値を返し、エラーを示すその他の数値を返します。

正常終了しました。

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

指定されていないエラー。

オブジェクトが無効です。

オブジェクトは既にあります。

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

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

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

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

共有違反です。

開始ファイルが無効です。

特権が保持されていません。

無効なパラメーター。

このメソッドは現在、WMI では実装されていません。このメソッドを使用するには、独自のプロバイダーに実装する必要があります。

このドキュメントは、DMTF によって発行された CIM クラスの説明から派生しています。 Microsoft は、軽微なエラーの修正、Microsoft SDK ドキュメント標準への準拠、または詳細情報の提供を行うために変更を加えた可能性があります。