IOleUndoUnit::OnNextAdd メソッド (ocidl.h)

コレクション内の最後の元に戻す単位に、新しい単位が追加されたことを通知します。

構文

HRESULT OnNextAdd();

戻り値

このメソッドの実装では、常にS_OKが返されます。 HRESULT 戻り値の型は、リモート処理の可能性のためにのみ使用されます。

注釈

オブジェクトは、アクションの元に戻す単位を作成し、元に戻すマネージャーに追加できますが、プライベート インターフェイスを介してデータを挿入し続けることができます。 元に戻すユニットは、このメソッドの呼び出しを受け取ると、コンテキストが変更されたことを作成オブジェクトに伝えます。 その後、オブジェクトの作成は元に戻す単位にデータの挿入を停止します。

親の元に戻す単位は、コンテキストが変更され、新しい元に戻す単位が追加されたことを子ユニットに通知するために、最後に追加された子の元に戻す単位でこのメソッドを呼び出します。

たとえば、このメソッドは、入力などのあいまいなアクションをサポートするために使用されます。これは、明確な終了点を持たず、代わりに何か他のことが発生した場合にのみ終了します。

元に戻すマネージャーまたは開いている親ユニットが、代わりに IUnknown::Release を呼び出してユニットを破棄することを選択した場合、このメソッドは常に呼び出されるとは限りません。 プライベート インターフェイスを介してバックグラウンドで元に戻すユニットにデータをフィードする接続は、元に戻す単位 を IUnknown::AddRef にすることはできません。

実装者へのメモ

親ユニットは、このメソッドを最後に追加した子ユニットに委任するだけです。 親ユニットは、プライベート インターフェイスが閉じられたときに通信を終了する必要があります。 親ユニットは、 IOleParentUndoUnit::Close の呼び出しからS_FALSEを受信したときに閉じられていることを認識します。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	ocidl.h

こちらもご覧ください

IOleParentUndoUnit::Close

IOleUndoUnit