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

IRTCClientPresence2

COM
IIDad1809e8-62f7-4783-909a-29c9d2cb1d34継承元IRTCClientPresence自前メソッド開始 vtbl21

メソッド 15

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

vtbl 21 HRESULT EnablePresenceEx(IRTCProfile* pProfile, VARIANT varStorage, INT lFlags)
pProfileIRTCProfile*in使用するプロファイルを表す IRTCProfile を指定する。NULL を指定できる。
varStorageVARIANTinプレゼンス情報の保存先を表すストレージを指定する VARIANT である。
lFlagsINTinプレゼンス有効化時の動作を制御するフラグを指定する。
vtbl 22 HRESULT DisablePresence()
vtbl 23 HRESULT AddGroup(LPWSTR bstrGroupName, LPWSTR bstrData, IRTCProfile* pProfile, INT lFlags, IRTCBuddyGroup** ppGroup)
bstrGroupNameLPWSTRin追加するバディグループの名前を指定する。
bstrDataLPWSTRinグループに関連付ける任意のデータを指定する。
pProfileIRTCProfile*in使用するプロファイルを表す IRTCProfile を指定する。NULL を指定できる。
lFlagsINTin追加時の動作を制御するフラグを指定する。
ppGroupIRTCBuddyGroup**out追加されたグループを表す IRTCBuddyGroup を受け取るポインタである。
vtbl 24 HRESULT RemoveGroup(IRTCBuddyGroup* pGroup)
pGroupIRTCBuddyGroup*in削除するグループを表す IRTCBuddyGroup を指定する。
vtbl 25 HRESULT EnumerateGroups(IRTCEnumGroups** ppEnum)
ppEnumIRTCEnumGroups**outバディグループを列挙する IRTCEnumGroups を受け取るポインタである。
vtbl 26 HRESULT get_Groups(IRTCCollection** ppCollection)
ppCollectionIRTCCollection**outすべてのグループを格納した IRTCCollection を受け取るポインタである。
vtbl 27 HRESULT get_Group(LPWSTR bstrGroupName, IRTCBuddyGroup** ppGroup)
bstrGroupNameLPWSTRin取得するグループの名前を指定する。
ppGroupIRTCBuddyGroup**out取得したグループを表す IRTCBuddyGroup を受け取るポインタである。
vtbl 28 HRESULT AddWatcherEx(LPWSTR bstrPresentityURI, LPWSTR bstrUserName, LPWSTR bstrData, RTC_WATCHER_STATE enState, VARIANT_BOOL fPersistent, RTC_ACE_SCOPE enScope, IRTCProfile* pProfile, INT lFlags, IRTCWatcher2** ppWatcher)
bstrPresentityURILPWSTRin追加するウォッチャーのプレゼンス URI を指定する。
bstrUserNameLPWSTRinウォッチャーの表示名を指定する。
bstrDataLPWSTRinウォッチャーに関連付ける任意のデータを指定する。
enStateRTC_WATCHER_STATEinウォッチャーの初期状態を表す RTC_WATCHER_STATE を指定する。
fPersistentVARIANT_BOOLinウォッチャーを永続化するかどうかを指定するブール値である。
enScopeRTC_ACE_SCOPEinアクセス制御の適用範囲を表す RTC_ACE_SCOPE を指定する。
pProfileIRTCProfile*in使用するプロファイルを表す IRTCProfile を指定する。NULL を指定できる。
lFlagsINTin追加時の動作を制御するフラグを指定する。
ppWatcherIRTCWatcher2**out追加されたウォッチャーを表す IRTCWatcher2 を受け取るポインタである。
vtbl 29 HRESULT get_WatcherEx(RTC_WATCHER_MATCH_MODE enMode, LPWSTR bstrPresentityURI, IRTCWatcher2** ppWatcher)
enModeRTC_WATCHER_MATCH_MODEinURI の照合方法を表す RTC_WATCHER_MATCH_MODE を指定する。
bstrPresentityURILPWSTRin取得するウォッチャーのプレゼンス URI を指定する。
ppWatcherIRTCWatcher2**out取得したウォッチャーを表す IRTCWatcher2 を受け取るポインタである。
vtbl 30 HRESULT put_PresenceProperty(RTC_PRESENCE_PROPERTY enProperty, LPWSTR bstrProperty)
enPropertyRTC_PRESENCE_PROPERTYin設定するプレゼンスプロパティを表す RTC_PRESENCE_PROPERTY を指定する。
bstrPropertyLPWSTRinプロパティに設定する値の文字列を指定する。
vtbl 31 HRESULT get_PresenceProperty(RTC_PRESENCE_PROPERTY enProperty, LPWSTR* pbstrProperty)
enPropertyRTC_PRESENCE_PROPERTYin取得するプレゼンスプロパティを表す RTC_PRESENCE_PROPERTY を指定する。
pbstrPropertyLPWSTR*outプロパティの値を受け取るポインタである。
vtbl 32 HRESULT SetPresenceData(LPWSTR bstrNamespace, LPWSTR bstrData)
bstrNamespaceLPWSTRinプレゼンスデータの名前空間を指定する。
bstrDataLPWSTRin設定するプレゼンスデータを指定する。
vtbl 33 HRESULT GetPresenceData(LPWSTR* pbstrNamespace, LPWSTR* pbstrData)
pbstrNamespaceLPWSTR*out取得したプレゼンスデータの名前空間を受け取るポインタである。
pbstrDataLPWSTR*out取得したプレゼンスデータを受け取るポインタである。
vtbl 34 HRESULT GetLocalPresenceInfo(RTC_PRESENCE_STATUS* penStatus, LPWSTR* pbstrNotes)
penStatusRTC_PRESENCE_STATUS*out現在のローカルプレゼンス状態を受け取るポインタである。
pbstrNotesLPWSTR*outプレゼンスに付随するメモ(注記)文字列を受け取るポインタである。
vtbl 35 HRESULT AddBuddyEx(LPWSTR bstrPresentityURI, LPWSTR bstrUserName, LPWSTR bstrData, VARIANT_BOOL fPersistent, RTC_BUDDY_SUBSCRIPTION_TYPE enSubscriptionType, IRTCProfile* pProfile, INT lFlags, IRTCBuddy2** ppBuddy)
bstrPresentityURILPWSTRin追加するバディのプレゼンス URI を指定する。
bstrUserNameLPWSTRinバディの表示名を指定する。
bstrDataLPWSTRinバディに関連付ける任意のデータを指定する。
fPersistentVARIANT_BOOLinバディを永続化するかどうかを指定するブール値である。
enSubscriptionTypeRTC_BUDDY_SUBSCRIPTION_TYPEinプレゼンス購読の種別を表す RTC_BUDDY_SUBSCRIPTION_TYPE を指定する。
pProfileIRTCProfile*in使用するプロファイルを表す IRTCProfile を指定する。NULL を指定できる。
lFlagsINTin追加時の動作を制御するフラグを指定する。
ppBuddyIRTCBuddy2**out追加されたバディを表す IRTCBuddy2 を受け取るポインタである。

HSP用 COM定義

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

出力引数:
#define global IID_IRTCClientPresence2 "{AD1809E8-62F7-4783-909A-29C9D2CB1D34}"
#usecom global IRTCClientPresence2 IID_IRTCClientPresence2 "{}"
#comfunc global IRTCClientPresence2_EnablePresenceEx      21 sptr,int,int
#comfunc global IRTCClientPresence2_DisablePresence       22
#comfunc global IRTCClientPresence2_AddGroup              23 wstr,wstr,sptr,int,sptr
#comfunc global IRTCClientPresence2_RemoveGroup           24 sptr
#comfunc global IRTCClientPresence2_EnumerateGroups       25 sptr
#comfunc global IRTCClientPresence2_get_Groups            26 sptr
#comfunc global IRTCClientPresence2_get_Group             27 wstr,sptr
#comfunc global IRTCClientPresence2_AddWatcherEx          28 wstr,wstr,wstr,int,int,int,sptr,int,sptr
#comfunc global IRTCClientPresence2_get_WatcherEx         29 int,wstr,sptr
#comfunc global IRTCClientPresence2_put_PresenceProperty  30 int,wstr
#comfunc global IRTCClientPresence2_get_PresenceProperty  31 int,var
#comfunc global IRTCClientPresence2_SetPresenceData       32 wstr,wstr
#comfunc global IRTCClientPresence2_GetPresenceData       33 var,var
#comfunc global IRTCClientPresence2_GetLocalPresenceInfo  34 var,var
#comfunc global IRTCClientPresence2_AddBuddyEx            35 wstr,wstr,wstr,int,int,sptr,int,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。