Win32 API 日本語リファレンス
ホーム › Networking.BackgroundIntelligentTransferService › IBackgroundCopyFile5

IBackgroundCopyFile5

COM
📘 Microsoft Learn (日本語) · English
IID85c1657f-dafc-40e8-8834-df18ea25717e継承元IBackgroundCopyFile4自前メソッド開始 vtbl13

公式ドキュメント

このインターフェイスは、BITS ファイル転送の汎用プロパティを取得または設定するために使用します。

メソッド 2

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

vtbl 13 HRESULT SetProperty(BITS_FILE_PROPERTY_ID PropertyId, BITS_FILE_PROPERTY_VALUE PropertyValue)

BITS ファイル転送の汎用プロパティを設定します。

PropertyIdBITS_FILE_PROPERTY_IDin設定するプロパティを指定します。
PropertyValueBITS_FILE_PROPERTY_VALUEin設定する値を指定する共用体へのポインター。プロパティ ID に対応する共用体メンバーが使用されます。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 14 HRESULT GetProperty(BITS_FILE_PROPERTY_ID PropertyId, BITS_FILE_PROPERTY_VALUE* PropertyValue)

BITS ファイル転送の汎用プロパティを取得します。

PropertyIdBITS_FILE_PROPERTY_IDin値を取得するファイルプロパティを指定します。
PropertyValueBITS_FILE_PROPERTY_VALUE*outプロパティの値。BITS_FILE_PROPERTY_VALUE 共用体へのポインターとして返されます。渡したプロパティ ID の値に対応する共用体のフィールドを使用してください。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IBackgroundCopyFile5 "{85C1657F-DAFC-40E8-8834-DF18EA25717E}"
#usecom global IBackgroundCopyFile5 IID_IBackgroundCopyFile5 "{}"
#comfunc global IBackgroundCopyFile5_SetProperty  13 int,int
#comfunc global IBackgroundCopyFile5_GetProperty  14 int,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。