IReconcileInitiator::SetAbortCallback メソッド (reconcil.h)
イニシエーターが調整を非同期的に終了できるオブジェクトを設定します。 通常、ブリーフケースリコンサイル機能は、長い調整やユーザー操作を伴う調整に対してこのオブジェクトを設定します。
構文
HRESULT SetAbortCallback(
IUnknown *punkForAbort
);
パラメーター
punkForAbort
種類: IUnknown*
オブジェクトの IUnknown インターフェイスのアドレス。 イニシエーターは、 IUnknown::Release メソッドを使用してオブジェクトを解放することで、調整を終了するように要求を通知します。 このパラメーターは、前に指定したオブジェクトを削除するようにイニシエーターに指示するために NULL にすることができます 。
戻り値
種類: HRESULT
成功した場合はS_OK値を返し、それ以外の場合は次のいずれかのエラー値を返します。
リターン コード | 説明 |
---|---|
|
イニシエーターは調整操作の終了をサポートせず、指定されたオブジェクトを保持しません。 |
|
未定義のエラーが発生しました。 |
注釈
イニシエーターは、オブジェクトを受け入れるか拒否できます。 イニシエーターがオブジェクトを受け入れる場合、ブリーフケースリコンサイルは、調整が完了したときに NULL パラメーターを使用してこのメソッドを呼び出してオブジェクトを削除する必要があります。 調整が完了すると、リコンサイル機能によってオブジェクトが削除されるため、調整完了後にイニシエーターがオブジェクトを解放する場合があります。 このような場合、リコンサイルは終了要求を無視します。
調整が終了した場合、 Reconcile メソッドは REC_E_ABORTED または REC_E_NOTCOMPLETE 値を返す必要があります。
要件
サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | reconcil.h |
[DLL] | Shell32.dll (バージョン 4.0 以降) |