AtlComQIPtrAssign
あるインターフェイス ポインターを異なる型の別のインターフェイス ポインターに割り当てます。
ATLINLINE ATLAPI_(IUnknown*) AtlComQIPtrAssign(
IUnknown** pp,
IUnknown* lp,
REFIID riid
);
パラメーター
pp
別のポインターを割り当てる IUnknown ポインターのアドレス。lp
pp とは異なる型の IUnknown ポインター。 このポインターが pp のポインターに割り当てられます。riid
要求されたインターフェイスの IID。
戻り値
エラーの場合は NULL を返します。それ以外の場合は lp を返します。
解説
この関数は、COM 参照カウント規則を使用してインターフェイス ポインターをコピーします。 この関数は、lp に対して QueryInterface を呼び出し、riid を指定して必要なインターフェイスを取得します。 次に、pp が指すインターフェイスの Release を呼び出し、QueryInterface が返すポインターを割り当てます。
このスマート ポインター ヘルパー関数は、CComPtr クラスと CComQIPtr クラスで使用されます。
必要条件
**ヘッダー:**atlcomcli.h