完全修飾ファイル名のリストを前提に、この関数はローカル ドライブにチェックアウトします。 コメントは、チェックアウトされているすべてのファイルに適用されます。コメント引数には null
文字列を指定できます。
構文
SCCRTN SccCheckout (
LPVOID pvContext,
HWND hWnd,
LONG nFiles,
LPCSTR* lpFileNames,
LPCSTR lpComment,
LONG fOptions,
LPCMDOPTS pvOptions
);
パラメーター
pvContext
[入力] ソース管理プラグインのコンテキスト構造体。
hWnd
[入力] ソース管理プラグインが、提供するすべてのダイアログ ボックスの親として使用できる IDE ウィンドウへのハンドル。
nFiles
[入力] チェックアウト対象として選択されたファイルの数。
lpFileNames
[入力] チェックアウトするファイルの完全修飾ローカル パス名の配列。
lpComment
[入力] チェックアウトされる選択された各ファイルに適用されるコメント。
fOptions
[入力] コマンド フラグ (「特定のコマンドで使用されるビットフラグ」を参照)。
pvOptions
[入力] ソース管理プラグイン固有のオプション。
戻り値
この関数のソース管理プラグインの実装では、次のいずれかの値が返されることが予期されています。
Value | 説明 |
---|---|
SCC_OK | チェックアウトに成功しました。 |
SCC_E_FILENOTCONTROLLED | 選択したファイルはソース コード管理下にありません。 |
SCC_E_ACCESSFAILURE | ソース管理システムへのアクセス中に問題が発生しました。ネットワークまたは競合の問題である可能性があります。 再試行することをお勧めします。 |
SCC_E_NOTAUTHORIZED | ユーザーには、この操作の実行が許可されていません。 |
SCC_E_NONSPECIFICERROR | 不特定のエラーです。 ファイルはチェックアウトされませんでした。 |
SCC_E_ALREADYCHECKEDOUT | ユーザーは既にファイルをチェックアウトしています。 |
SCC_E_FILEISLOCKED | ファイルがロックされているため、新しいバージョンの作成が禁止されています。 |
SCC_E_FILEOUTEXCLUSIVE | 別のユーザーがこのファイルに対して排他的チェックアウトを実行しました。 |
SCC_I_OPERATIONCANCELED | 操作は完了前にキャンセルされました。 |