Win32 API 日本語リファレンス
ホームSystem.Contacts › IContactManager

IContactManager

COM
IIDad553d98-deb1-474a-8e17-fc0c2075b738継承元IUnknown自前メソッド開始 vtbl3

メソッド 6

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT Initialize(LPWSTR pszAppName, LPWSTR pszAppVersion)
pszAppNameLPWSTRin連絡先マネージャーを利用する呼び出し元アプリケーションの名前を指定するワイド文字列である。
pszAppVersionLPWSTRin呼び出し元アプリケーションのバージョンを指定するワイド文字列である。
vtbl 4 HRESULT Load(LPWSTR pszContactID, IContact** ppContact)
pszContactIDLPWSTRin読み込む連絡先を識別する連絡先 ID を指定するワイド文字列である。
ppContactIContact**out読み込まれた連絡先を表す IContact インターフェイスを受け取るポインタのポインタである。
vtbl 5 HRESULT MergeContactIDs(LPWSTR pszNewContactID, LPWSTR pszOldContactID)
pszNewContactIDLPWSTRin統合後に有効とする新しい連絡先 ID を指定するワイド文字列である。
pszOldContactIDLPWSTRin新しい ID に統合 (置換) される古い連絡先 ID を指定するワイド文字列である。
vtbl 6 HRESULT GetMeContact(IContact** ppMeContact)
ppMeContactIContact**out現在のユーザー自身を表す "自分" 連絡先 (IContact) を受け取るポインタのポインタである。
vtbl 7 HRESULT SetMeContact(IContact* pMeContact)
pMeContactIContact*in"自分" 連絡先として設定する連絡先を表す IContact インターフェイスへのポインタである。
vtbl 8 HRESULT GetContactCollection(IContactCollection** ppContactCollection)
ppContactCollectionIContactCollection**outすべての連絡先を列挙する IContactCollection インターフェイスを受け取るポインタのポインタである。

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"

#define global IID_IContactManager "{AD553D98-DEB1-474A-8E17-FC0C2075B738}"
#usecom global IContactManager IID_IContactManager "{7165C8AB-AF88-42BD-86FD-5310B4285A02}"
#comfunc global IContactManager_Initialize            3 wstr,wstr
#comfunc global IContactManager_Load                  4 wstr,sptr
#comfunc global IContactManager_MergeContactIDs       5 wstr,wstr
#comfunc global IContactManager_GetMeContact          6 sptr
#comfunc global IContactManager_SetMeContact          7 sptr
#comfunc global IContactManager_GetContactCollection  8 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。