次の方法で共有


SccRename 関数

この関数は、ソース管理システム内のファイルの名前を変更します。

構文

SCCRTN SccRename(
   LPVOID pvContext,
   HWND   hWnd,
   LPCSTR lpFileName,
   LPCSTR lpNewName
);

パラメーター

pvContext

[入力] ソース管理プラグインのコンテキスト構造体。

hWnd

[入力] ソース管理プラグインが、提供するすべてのダイアログ ボックスの親として使用できる IDE ウィンドウへのハンドル。

lpFileName

[入力] 名前が変更されるファイルの完全修飾ファイル名。

lpNewName

[入力] 完全修飾の新しい名前。 ディレクトリ パスが異なる場合、ファイルはあるサブディレクトリから別のサブディレクトリに移動されています。

戻り値

この関数のソース管理プラグインの実装では、次のいずれかの値が返されることが予期されています。

Value 説明
SCC_OK 名前の変更操作は正常に完了しました。
SCC_E_PROJNOTOPEN プロジェクトがソース管理下で開かれていません。
SCC_E_FILENOTCONTROLLED ファイルはソース管理されていません。
SCC_E_ACCESSFAILURE ソース管理システムへのアクセス中に問題が発生しました。ネットワークまたは競合の問題である可能性があります。
SCC_E_NOTAUTHORIZED ユーザーにはこの操作を完了する権限がありません。
SCC_E_COULDNOTCREATEPROJECT 名前の変更プロセスの一部としてプロジェクトを作成できませんでした。
SCC_E_OPNOTPERFORMED 操作が実行されませんでした。
SCC_E_NONSPECIFICERROR 指定されていないエラーまたは一般的なエラーが発生しました。

解説

この関数を使用すると、ファイルの名前を変更したり、ソース管理システム内のある場所から別の場所にファイルを移動したりすることができます。 ソース管理プラグインでディスク上のファイルへアクセスしようとしないでください。 ローカル ファイルの名前を変更するのは IDE の役割です。

関連項目