IUnknown

クライアントが QueryInterface メソッドを通じて特定のオブジェクト上の他のインターフェイスへのポインターを取得し、AddRef および Release メソッドを通じてオブジェクトの存続を管理できるようにします。

COM オブジェクトへのインターフェイス ポインターの参照カウントをインクリメントします。インターフェイス ポインターのコピーを作成するたびに、このメソッドを呼び出す必要があります。

このメソッドは新しい参照カウントを返します。この値はテスト目的でのみ使用することを意図しています。

COM オブジェクトは、オブジェクトへの参照よりも長く存続しないようにするために、インターフェイスごとの参照カウント機構を使用します。インターフェイス ポインターのコピーを安定させるには AddRef を使用します。また、複製したポインターの存続期間を元のポインターの存続期間を超えて延長する必要がある場合にも呼び出せます。複製したポインターは、それに対して IUnknown::Release を呼び出して解放する必要があります。

AddRef が保持する内部参照カウンターは、32 ビットの符号なし整数であるべきです。

呼び出し元への注意

作成するインターフェイス ポインターの新しいコピーごとに、このメソッドを呼び出してください。たとえば、メソッドからポインターのコピーを返す場合は、そのポインターに対して AddRef を呼び出す必要があります。また、ポインターを in-out パラメーターとしてメソッドに渡す前にも AddRef を呼び出す必要があります。メソッドは、out 値をポインターの上にコピーする前に IUnknown::Release を呼び出します。

COM オブジェクト上のインターフェイスの参照カウントをデクリメントします。

このメソッドは新しい参照カウントを返します。この値はテスト目的でのみ使用することを意図しています。

オブジェクトの参照カウントがゼロに達すると、Release はインターフェイス ポインターに自身を解放させる必要があります。解放されるポインターがオブジェクトに対する唯一の（それまで存在していた）参照である場合（オブジェクトが単一のインターフェイスをサポートするか複数のインターフェイスをサポートするかにかかわらず）、実装はそのオブジェクトを解放する必要があります。

オブジェクトの集約（アグリゲーション）は、インターフェイス ポインターを取得する能力を制限することに注意してください。

呼び出し元への注意

インターフェイス ポインターを使用する必要がなくなったら、このメソッドを呼び出してください。in-out パラメーターを受け取るメソッドを記述している場合は、out 値をポインターの上にコピーする前に、渡されたポインターに対して Release を呼び出してください。