AtlComQIPtrAssign
更新 : 2007 年 11 月
あるインターフェイス ポインタを異なる型の別のインターフェイス ポインタに割り当てます。
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