ホーム › System.AddressBook › IMAPITable
IMAPITable
COMメソッド 23
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
| hResult | HRESULT | in | 詳細なエラー情報を取得する対象の HRESULT エラーコードを指定する。 |
| ulFlags | DWORD | in | 文字列の形式 (ANSI/Unicode) を制御するフラグを指定する。 |
| lppMAPIError | MAPIERROR** | inout | エラーの詳細を格納した MAPIERROR 構造体を受け取るポインタである。 |
vtbl 4 HRESULT Advise(DWORD ulEventMask, IMAPIAdviseSink* lpAdviseSink, DWORD* lpulConnection)
| ulEventMask | DWORD | in | 通知を受け取るイベントの種類を示すマスクを指定する。 |
| lpAdviseSink | IMAPIAdviseSink* | in | 通知を受け取るアドバイズシンク IMAPIAdviseSink を指定する。 |
| lpulConnection | DWORD* | inout | 確立された通知接続を識別する接続番号を受け取る変数へのポインタである。 |
| ulConnection | DWORD | in | 解除する通知接続を識別する接続番号を指定する。 |
| lpulTableStatus | DWORD* | inout | テーブルの現在のステータスを受け取る変数へのポインタである。 |
| lpulTableType | DWORD* | inout | テーブルの種別を受け取る変数へのポインタである。 |
vtbl 7 HRESULT SetColumns(SPropTagArray* lpPropTagArray, DWORD ulFlags)
| lpPropTagArray | SPropTagArray* | inout | テーブルの列として設定するプロパティのタグ配列 SPropTagArray へのポインタである。 |
| ulFlags | DWORD | in | 列設定の動作を制御するフラグを指定する。 |
vtbl 8 HRESULT QueryColumns(DWORD ulFlags, SPropTagArray** lpPropTagArray)
| ulFlags | DWORD | in | 取得する列の集合 (現在の列か全列か) を制御するフラグを指定する。 |
| lpPropTagArray | SPropTagArray** | inout | テーブルの列を構成するプロパティのタグ配列 SPropTagArray を受け取るポインタである。 |
| ulFlags | DWORD | in | 行数取得の動作を制御するフラグを指定する。 |
| lpulCount | DWORD* | inout | テーブルの行数を受け取る変数へのポインタである。 |
| bkOrigin | DWORD | in | シークの起点となるブックマークを指定する。 |
| lRowCount | INT | in | 起点から移動する行数を指定する。負の値は逆方向への移動を表す。 |
| lplRowsSought | INT* | inout | 実際に移動できた行数を受け取る変数へのポインタである。 |
| ulNumerator | DWORD | in | 目的位置を割合で示す分数の分子を指定する。 |
| ulDenominator | DWORD | in | 目的位置を割合で示す分数の分母を指定する。 |
| lpulRow | DWORD* | inout | 現在のカーソル行の位置を受け取る変数へのポインタである。 |
| lpulNumerator | DWORD* | inout | 現在位置を割合で示す分数の分子を受け取る変数へのポインタである。 |
| lpulDenominator | DWORD* | inout | 現在位置を割合で示す分数の分母を受け取る変数へのポインタである。 |
vtbl 13 HRESULT FindRow(SRestriction* lpRestriction, DWORD bkOrigin, DWORD ulFlags)
| lpRestriction | SRestriction* | inout | 検索条件を示す SRestriction へのポインタである。 |
| bkOrigin | DWORD | in | 検索を開始する起点となるブックマークを指定する。 |
| ulFlags | DWORD | in | 検索方向などを制御するフラグを指定する。 |
vtbl 14 HRESULT Restrict(SRestriction* lpRestriction, DWORD ulFlags)
| lpRestriction | SRestriction* | inout | テーブルに適用する絞り込み条件を示す SRestriction へのポインタである。制限を解除するには NULL を指定する。 |
| ulFlags | DWORD | in | 絞り込みの動作を制御するフラグを指定する。 |
| lpbkPosition | DWORD* | inout | 現在位置に作成されたブックマークを識別する値を受け取る変数へのポインタである。 |
| bkPosition | DWORD | in | 解放するブックマークを識別する値を指定する。 |
vtbl 17 HRESULT SortTable(SSortOrderSet* lpSortCriteria, DWORD ulFlags)
| lpSortCriteria | SSortOrderSet* | inout | テーブルに適用するソート条件を示す SSortOrderSet へのポインタである。 |
| ulFlags | DWORD | in | ソートの動作を制御するフラグを指定する。 |
vtbl 18 HRESULT QuerySortOrder(SSortOrderSet** lppSortCriteria)
| lppSortCriteria | SSortOrderSet** | inout | テーブルに現在適用されているソート条件 SSortOrderSet を受け取るポインタである。 |
| lRowCount | INT | in | 取得する最大行数を指定する。 |
| ulFlags | DWORD | in | 行取得の動作を制御するフラグを指定する。 |
| lppRows | SRowSet** | inout | 取得された行の集合 SRowSet を受け取るポインタである。 |
vtbl 20 HRESULT Abort()
vtbl 21 HRESULT ExpandRow(DWORD cbInstanceKey, BYTE* pbInstanceKey, DWORD ulRowCount, DWORD ulFlags, SRowSet** lppRows, DWORD* lpulMoreRows)
| cbInstanceKey | DWORD | in | pbInstanceKey が指すインスタンスキーのバイト数を指定する。 |
| pbInstanceKey | BYTE* | inout | 展開する見出し行のインスタンスキーを格納したバイト配列へのポインタである。 |
| ulRowCount | DWORD | in | 展開時に取得する最大行数を指定する。 |
| ulFlags | DWORD | in | 展開の動作を制御するフラグを指定する。 |
| lppRows | SRowSet** | inout | 展開によって得られた行の集合 SRowSet を受け取るポインタである。 |
| lpulMoreRows | DWORD* | inout | 未取得の残り行数を受け取る変数へのポインタである。 |
vtbl 22 HRESULT CollapseRow(DWORD cbInstanceKey, BYTE* pbInstanceKey, DWORD ulFlags, DWORD* lpulRowCount)
| cbInstanceKey | DWORD | in | pbInstanceKey が指すインスタンスキーのバイト数を指定する。 |
| pbInstanceKey | BYTE* | inout | 折りたたむ見出し行のインスタンスキーを格納したバイト配列へのポインタである。 |
| ulFlags | DWORD | in | 折りたたみの動作を制御するフラグを指定する。 |
| lpulRowCount | DWORD* | inout | 折りたたみによって隠された行数を受け取る変数へのポインタである。 |
| ulFlags | DWORD | in | 待機の動作を制御するフラグを指定する。 |
| ulTimeout | DWORD | in | 待機するタイムアウト時間をミリ秒単位で指定する。 |
| lpulTableStatus | DWORD* | inout | 完了後のテーブルステータスを受け取る変数へのポインタである。 |
vtbl 24 HRESULT GetCollapseState(DWORD ulFlags, DWORD cbInstanceKey, BYTE* lpbInstanceKey, DWORD* lpcbCollapseState, BYTE** lppbCollapseState)
| ulFlags | DWORD | in | 状態取得の動作を制御するフラグを指定する。 |
| cbInstanceKey | DWORD | in | lpbInstanceKey が指すインスタンスキーのバイト数を指定する。 |
| lpbInstanceKey | BYTE* | inout | 状態を取得する基準行のインスタンスキーを格納したバイト配列へのポインタである。 |
| lpcbCollapseState | DWORD* | inout | 返された折りたたみ状態データのバイト数を受け取る変数へのポインタである。 |
| lppbCollapseState | BYTE** | inout | テーブルの展開/折りたたみ状態を表すデータを受け取るバイト配列ポインタである。 |
vtbl 25 HRESULT SetCollapseState(DWORD ulFlags, DWORD cbCollapseState, BYTE* pbCollapseState, DWORD* lpbkLocation)
| ulFlags | DWORD | in | 状態復元の動作を制御するフラグを指定する。 |
| cbCollapseState | DWORD | in | pbCollapseState が指す状態データのバイト数を指定する。 |
| pbCollapseState | BYTE* | inout | 復元する展開/折りたたみ状態を表すデータを格納したバイト配列へのポインタである。 |
| lpbkLocation | DWORD* | inout | 復元後のカーソル位置を示すブックマークを受け取る変数へのポインタである。 |
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
出力引数:
#define global IID_IMAPITable "{}" #usecom global IMAPITable IID_IMAPITable "{}" #comfunc global IMAPITable_GetLastError 3 int,int,var #comfunc global IMAPITable_Advise 4 int,sptr,var #comfunc global IMAPITable_Unadvise 5 int #comfunc global IMAPITable_GetStatus 6 var,var #comfunc global IMAPITable_SetColumns 7 var,int #comfunc global IMAPITable_QueryColumns 8 int,var #comfunc global IMAPITable_GetRowCount 9 int,var #comfunc global IMAPITable_SeekRow 10 int,int,var #comfunc global IMAPITable_SeekRowApprox 11 int,int #comfunc global IMAPITable_QueryPosition 12 var,var,var #comfunc global IMAPITable_FindRow 13 var,int,int #comfunc global IMAPITable_Restrict 14 var,int #comfunc global IMAPITable_CreateBookmark 15 var #comfunc global IMAPITable_FreeBookmark 16 int #comfunc global IMAPITable_SortTable 17 var,int #comfunc global IMAPITable_QuerySortOrder 18 var #comfunc global IMAPITable_QueryRows 19 int,int,var #comfunc global IMAPITable_Abort 20 #comfunc global IMAPITable_ExpandRow 21 int,var,int,int,var,var #comfunc global IMAPITable_CollapseRow 22 int,var,int,var #comfunc global IMAPITable_WaitForCompletion 23 int,int,var #comfunc global IMAPITable_GetCollapseState 24 int,int,var,var,var #comfunc global IMAPITable_SetCollapseState 25 int,int,var,var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IMAPITable "{}" #usecom global IMAPITable IID_IMAPITable "{}" #comfunc global IMAPITable_GetLastError 3 int,int,sptr #comfunc global IMAPITable_Advise 4 int,sptr,sptr #comfunc global IMAPITable_Unadvise 5 int #comfunc global IMAPITable_GetStatus 6 sptr,sptr #comfunc global IMAPITable_SetColumns 7 sptr,int #comfunc global IMAPITable_QueryColumns 8 int,sptr #comfunc global IMAPITable_GetRowCount 9 int,sptr #comfunc global IMAPITable_SeekRow 10 int,int,sptr #comfunc global IMAPITable_SeekRowApprox 11 int,int #comfunc global IMAPITable_QueryPosition 12 sptr,sptr,sptr #comfunc global IMAPITable_FindRow 13 sptr,int,int #comfunc global IMAPITable_Restrict 14 sptr,int #comfunc global IMAPITable_CreateBookmark 15 sptr #comfunc global IMAPITable_FreeBookmark 16 int #comfunc global IMAPITable_SortTable 17 sptr,int #comfunc global IMAPITable_QuerySortOrder 18 sptr #comfunc global IMAPITable_QueryRows 19 int,int,sptr #comfunc global IMAPITable_Abort 20 #comfunc global IMAPITable_ExpandRow 21 int,sptr,int,int,sptr,sptr #comfunc global IMAPITable_CollapseRow 22 int,sptr,int,sptr #comfunc global IMAPITable_WaitForCompletion 23 int,int,sptr #comfunc global IMAPITable_GetCollapseState 24 int,int,sptr,sptr,sptr #comfunc global IMAPITable_SetCollapseState 25 int,int,sptr,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。