SccDiff 関数

この関数は、ソース管理システムで現在のファイル (ローカル ディスク上) と最後にチェックインされたバージョンとの差異を表示します (または必要に応じて差異の有無の確認のみを行います)。

構文

SCCRTN SccDiff(
   LPVOID    pvContext,
   HWND      hWnd,
   LPCSTR    lpFileName,
   LONG      fOptions,
   LPCMDOPTS pvOptions
);

パラメーター

pvContext

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

hWnd

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

lpFileName

[入力] 差異が要求されるファイルの名前。

fOptions

[入力] コマンド フラグ。 詳細については、「解説」を参照してください。

pvOptions

[入力] ソース管理プラグイン固有のオプション。

戻り値

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

解説

この関数は、2 つの異なる目的を果たします。 既定では、ファイルに対する変更の一覧が表示されます。 ソース管理プラグインは、選択した形式で独自のウィンドウを開き、ディスク上のユーザーのファイルと、ソース管理下にあるファイルの最新バージョンとの差異を表示します。

または、IDE で、単にファイルが変更されたかどうかを判断する必要がある場合があります。 たとえば、IDE では、ユーザーに通知することなくファイルをチェックアウトしても安全かどうかを判断する必要がある場合があります。 その場合は、IDE によって SCC_DIFF_CONTENTS フラグが渡されます。 ソース管理プラグインでは、ソース管理下にあるファイルに対してディスク上のファイルをバイト単位でチェックし、ユーザーに何も表示せずに 2 つのファイルが異なるかどうかを示す値を返す必要があります。

パフォーマンスを最適化するために、ソース管理プラグインでは、SCC_DIFF_CONTENTS によって要求されるバイト単位の比較ではなく、チェックサムまたはタイムスタンプに基づく代替策を使用する場合があります。この形式の比較は明らかに高速ですが、信頼性は低くなります。 すべてのソース管理システムでこれらの代替の比較方法がサポートされるとは限りません。また、プラグインでコンテンツ比較へのフォールバックが必要になる場合があります。 すべてのソース管理プラグインで、少なくともコンテンツ比較をサポートしている必要があります。

関連項目

• ソース管理プラグインの API 関数