ホーム › Networking.BackgroundIntelligentTransferService › IBackgroundCopyJob1
IBackgroundCopyJob1
COMメソッド 8
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
vtbl 3 HRESULT CancelJob()
| dwFlags | DWORD | in | 取得する進捗情報の種類を指定するフラグ。 |
| pdwProgress | DWORD* | out | ジョブの進捗状況を受け取る出力ポインタ。 |
vtbl 5 HRESULT GetStatus(DWORD* pdwStatus, DWORD* pdwWin32Result, DWORD* pdwTransportResult, DWORD* pdwNumOfRetries)
| pdwStatus | DWORD* | out | ジョブの現在の状態コードを受け取る出力ポインタ。 |
| pdwWin32Result | DWORD* | out | 発生したWin32エラーコードを受け取る出力ポインタ。 |
| pdwTransportResult | DWORD* | out | 転送層(HTTP等)の結果コードを受け取る出力ポインタ。 |
| pdwNumOfRetries | DWORD* | out | これまでの再試行回数を受け取る出力ポインタ。 |
vtbl 6 HRESULT AddFiles(DWORD cFileCount, FILESETINFO** ppFileSet)
| cFileCount | DWORD | in | ppFileSet配列に含まれる追加するファイルの数。 |
| ppFileSet | FILESETINFO** | in | ジョブに追加するファイル情報を記述するFILESETINFO構造体ポインタの配列。 |
vtbl 7 HRESULT GetFile(DWORD cFileIndex, FILESETINFO* pFileInfo)
| cFileIndex | DWORD | in | 取得するファイルのゼロ基点インデックス。 |
| pFileInfo | FILESETINFO* | out | 指定インデックスのファイル情報を受け取るFILESETINFO構造体ポインタ。 |
| pdwFileCount | DWORD* | out | ジョブに含まれるファイルの総数を受け取る出力ポインタ。 |
vtbl 9 HRESULT SwitchToForeground()
vtbl 10 HRESULT get_JobID(GUID* pguidJobID)
| pguidJobID | GUID* | out | ジョブを一意に識別するGUIDを受け取る出力ポインタ。 |
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
出力引数:
#define global IID_IBackgroundCopyJob1 "{59F5553C-2031-4629-BB18-2645A6970947}" #usecom global IBackgroundCopyJob1 IID_IBackgroundCopyJob1 "{}" #comfunc global IBackgroundCopyJob1_CancelJob 3 #comfunc global IBackgroundCopyJob1_GetProgress 4 int,var #comfunc global IBackgroundCopyJob1_GetStatus 5 var,var,var,var #comfunc global IBackgroundCopyJob1_AddFiles 6 int,var #comfunc global IBackgroundCopyJob1_GetFile 7 int,var #comfunc global IBackgroundCopyJob1_GetFileCount 8 var #comfunc global IBackgroundCopyJob1_SwitchToForeground 9 #comfunc global IBackgroundCopyJob1_get_JobID 10 var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IBackgroundCopyJob1 "{59F5553C-2031-4629-BB18-2645A6970947}" #usecom global IBackgroundCopyJob1 IID_IBackgroundCopyJob1 "{}" #comfunc global IBackgroundCopyJob1_CancelJob 3 #comfunc global IBackgroundCopyJob1_GetProgress 4 int,sptr #comfunc global IBackgroundCopyJob1_GetStatus 5 sptr,sptr,sptr,sptr #comfunc global IBackgroundCopyJob1_AddFiles 6 int,sptr #comfunc global IBackgroundCopyJob1_GetFile 7 int,sptr #comfunc global IBackgroundCopyJob1_GetFileCount 8 sptr #comfunc global IBackgroundCopyJob1_SwitchToForeground 9 #comfunc global IBackgroundCopyJob1_get_JobID 10 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。