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

IContactPropertyCollection

COM
📘 Microsoft Learn (日本語) · English
IIDffd3adf8-fa64-4328-b1b6-2e0db509cb3c継承元IUnknown自前メソッド開始 vtbl3

メソッド 7

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

vtbl 3 HRESULT Reset()
vtbl 4 HRESULT Next()
vtbl 5 HRESULT GetPropertyName(LPWSTR pszPropertyName, DWORD cchPropertyName, DWORD* pdwcchPropertyNameRequired)
pszPropertyNameLPWSTRinout現在のプロパティ名を受け取るバッファへのポインタである。NULL を指定して必要なサイズの問い合わせのみを行える。
cchPropertyNameDWORDinpszPropertyName バッファのサイズを文字数で指定する。
pdwcchPropertyNameRequiredDWORD*inout終端 NULL を含めて必要なバッファサイズ(文字数)を受け取る変数へのポインタである。
vtbl 6 HRESULT GetPropertyType(DWORD* pdwType)
pdwTypeDWORD*inout現在のプロパティの型を表す値を受け取る変数へのポインタである。
vtbl 7 HRESULT GetPropertyVersion(DWORD* pdwVersion)
pdwVersionDWORD*inout現在のプロパティのバージョン番号を受け取る変数へのポインタである。
vtbl 8 HRESULT GetPropertyModificationDate(FILETIME* pftModificationDate)
pftModificationDateFILETIME*inout現在のプロパティが最後に変更された日時を UTC の FILETIME として受け取る構造体へのポインタである。
vtbl 9 HRESULT GetPropertyArrayElementID(LPWSTR pszArrayElementID, DWORD cchArrayElementID, DWORD* pdwcchArrayElementIDRequired)
pszArrayElementIDLPWSTRinout配列プロパティ内の現在の要素の識別子を受け取るバッファへのポインタである。NULL を指定して必要なサイズの問い合わせのみを行える。
cchArrayElementIDDWORDinpszArrayElementID バッファのサイズを文字数で指定する。
pdwcchArrayElementIDRequiredDWORD*inout終端 NULL を含めて必要なバッファサイズ(文字数)を受け取る変数へのポインタである。

HSP用 COM定義

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

出力引数: 
#define global IID_IContactPropertyCollection "{FFD3ADF8-FA64-4328-B1B6-2E0DB509CB3C}"
#usecom global IContactPropertyCollection IID_IContactPropertyCollection "{}"
#comfunc global IContactPropertyCollection_Reset                        3
#comfunc global IContactPropertyCollection_Next                         4
#comfunc global IContactPropertyCollection_GetPropertyName              5 var,int,var
#comfunc global IContactPropertyCollection_GetPropertyType              6 var
#comfunc global IContactPropertyCollection_GetPropertyVersion           7 var
#comfunc global IContactPropertyCollection_GetPropertyModificationDate  8 var
#comfunc global IContactPropertyCollection_GetPropertyArrayElementID    9 var,int,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。