CIM_LogicalFile クラスの Rename メソッド
Rename メソッドは、オブジェクト パスで指定された論理ファイル (またはディレクトリ) の名前を変更します。 コピー先が別のドライブにある場合、または既存の論理ファイルを上書きする必要がある場合、名前の変更はサポートされていません。
重要
DMTF (分散管理タスク フォース) CIM (共通情報モデル) クラスは、WMI クラスが構築される親クラスです。 WMI では現在、 CIM 2.x バージョン スキーマのみがサポートされています。
このトピックでは、マネージド オブジェクト形式 (MOF) 構文を使用します。 このメソッドの使用方法の詳細については、「メソッドの 呼び出し」を参照してください。
構文
uint32 Rename(
[in] string FileName
);
パラメーター
-
FileName [in]
-
完全修飾新しいファイル (またはディレクトリ) 名。
例: "c:\temp\newfile.txt"
戻り値
成功した場合は 0 (ゼロ) の値を返し、エラーを示すその他の数値を返します。
-
Success
-
0
正常終了しました。
-
アクセスが拒否されました
-
2
アクセスが拒否されました。
-
不特定のエラー
-
8
指定されていないエラー。
-
無効なオブジェクト
-
9
オブジェクトが無効です。
-
オブジェクトは既に存在します
-
10
オブジェクトは既にあります。
-
ファイル システムが NTFS ではない
-
11
ファイル システムは NTFS ではありません。
-
NT/Windows 2000 以外のプラットフォーム
-
12
プラットフォームは Windows ではありません。
-
ドライブが同じではない
-
13
ドライブが同じではありません。
-
ディレクトリが空ではない
-
14
ディレクトリは空ではありません。
-
共有違反
-
15
共有違反です。
-
開始ファイルが無効です
-
16
開始ファイルが無効です。
-
特権が保持されていません
-
17
特権が保持されていません。
-
パラメーターが無効です
-
21
無効なパラメーター。
注釈
このメソッドは現在、WMI では実装されていません。 このメソッドを使用するには、独自のプロバイダーに実装する必要があります。
このドキュメントは、DMTF によって発行された CIM クラスの説明から派生しています。 Microsoft は、軽微なエラーの修正、Microsoft SDK ドキュメント標準への準拠、または詳細情報の提供を行うために変更を加えた可能性があります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows Vista |
サポートされている最小のサーバー |
Windows Server 2008 |
名前空間 |
Root\CIMV2 |
MOF |
|
[DLL] |
|