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

IContactManager

COM
📘 Microsoft Learn (日本語) · English
IIDad553d98-deb1-474a-8e17-fc0c2075b738継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

使用しないでください。連絡先 ID 文字列に基づいて連絡先を取得するために使用されていました。

メソッド 6

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

vtbl 3 HRESULT Initialize(LPWSTR pszAppName, LPWSTR pszAppVersion)

連絡先の操作に使用する一意のアプリケーション名とアプリケーションバージョンを指定して、連絡先マネージャーを初期化します。

pszAppNameLPWSTRinアプリケーション名を指定します。
pszAppVersionLPWSTRinアプリケーションバージョンを指定します。

戻り値

型: HRESULT

次のいずれかの値を返します。

戻り値 説明
S_OK

IContactManager が初期化されました。

解説(Remarks)

注意 このメソッドは、他の IContactManager メソッドよりも前に呼び出す必要があります。
vtbl 4 HRESULT Load(LPWSTR pszContactID, IContact** ppContact)

コンピューターローカルの連絡先 ID で参照される連絡先のデータを IContact オブジェクトに読み込みます。

pszContactIDLPWSTRin読み込む連絡先 ID を指定します。
ppContactIContact**out読み込み先の IContact オブジェクトを指定します。

戻り値

型: HRESULT

次のいずれかの値を返します。

戻り値 説明
S_OK
 連絡先が見つかり、読み込まれました。
ERROR_NO_MATCH
 この連絡先 ID が見つかりませんでした。
vtbl 5 HRESULT MergeContactIDs(LPWSTR pszNewContactID, LPWSTR pszOldContactID)

古い連絡先 ID が新しい連絡先 ID と同じ値に解決されるようにします。以降、古い連絡先 ID を指定して IContactManager::Load を呼び出すと、新しい連絡先 ID の連絡先が読み込まれるようになります。

pszNewContactIDLPWSTRin古い連絡先と新しい連絡先の両方を表す、新しい連絡先の ID を指定します。
pszOldContactIDLPWSTRin古い連絡先を表す ID を指定します。

戻り値

型: HRESULT

次のいずれかの値を返します。

戻り値 説明
S_OK
 アドレスの変更に成功しました。
vtbl 6 HRESULT GetMeContact(IContact** ppMeContact)

ローカルユーザーアカウントにおける「自分 (me)」の概念を取得します。

ppMeContactIContact**out「自分 (me)」の連絡先へのポインターを格納する場所を指定します。

戻り値

型: HRESULT

次のいずれかの値を返します。

戻り値 説明
S_OK
 取得に成功しました。
vtbl 7 HRESULT SetMeContact(IContact* pMeContact)

ローカルユーザーアカウントにおける「自分 (me)」の概念を、指定したユーザーに設定します。

pMeContactIContact*in現在のユーザーにとって「自分 (me)」として扱う連絡先を指定します。

戻り値

型: HRESULT

次のいずれかの値を返します。

戻り値 説明
S_OK
 設定に成功しました。
vtbl 8 HRESULT GetContactCollection(IContactCollection** ppContactCollection)

既知のすべての連絡先を含む IContactCollection オブジェクトを返します。

ppContactCollectionIContactCollection**out成功した場合、連絡先コレクションの列挙を格納します。

戻り値

型: HRESULT

次のいずれかの値を返します。

戻り値 説明
S_OK
 成功。ppContactCollection にコレクションが格納されます。

解説(Remarks)

新しいコレクションの列挙子は、最初の連絡先の前に設定されます。GetCurrent でコレクションを照会する前に、まず Next を呼び出す必要があります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

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 指定が可能。