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

IBackgroundCopyJobHttpOptions

COM
📘 Microsoft Learn (日本語) · English
IIDf1bd1079-9f01-4bdc-8036-f09b70095066継承元IUnknown自前メソッド開始 vtbl3

メソッド 8

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

vtbl 3 HRESULT SetClientCertificateByID(BG_CERT_STORE_LOCATION StoreLocation, LPWSTR StoreName, BYTE* pCertHashBlob)
StoreLocationBG_CERT_STORE_LOCATIONin証明書ストアの場所BG_CERT_STORE_LOCATION(現ユーザー/ローカルマシン等)。
StoreNameLPWSTRin証明書ストア名(例:MY)。
pCertHashBlobBYTE*in対象クライアント証明書のSHA-1ハッシュ(20バイト)。
vtbl 4 HRESULT SetClientCertificateByName(BG_CERT_STORE_LOCATION StoreLocation, LPWSTR StoreName, LPWSTR SubjectName)
StoreLocationBG_CERT_STORE_LOCATIONin証明書ストアの場所BG_CERT_STORE_LOCATION。
StoreNameLPWSTRin証明書ストア名(例:MY)。
SubjectNameLPWSTRin対象クライアント証明書のサブジェクト名。
vtbl 5 HRESULT RemoveClientCertificate()
vtbl 6 HRESULT GetClientCertificate(BG_CERT_STORE_LOCATION* pStoreLocation, LPWSTR* pStoreName, BYTE** ppCertHashBlob, LPWSTR* pSubjectName)
pStoreLocationBG_CERT_STORE_LOCATION*out設定済み証明書ストアの場所を受け取る出力ポインタ。
pStoreNameLPWSTR*out設定済み証明書ストア名を受け取る出力ポインタ。
ppCertHashBlobBYTE**out設定済み証明書のハッシュBLOBを受け取る出力ポインタ。
pSubjectNameLPWSTR*out設定済み証明書のサブジェクト名を受け取る出力ポインタ。
vtbl 7 HRESULT SetCustomHeaders(LPWSTR RequestHeaders)
RequestHeadersLPWSTRinHTTPリクエストに付加するカスタムヘッダー文字列。NULLで解除する。
vtbl 8 HRESULT GetCustomHeaders(LPWSTR* pRequestHeaders)
pRequestHeadersLPWSTR*out設定済みカスタムHTTPヘッダーを受け取る出力ポインタ。
vtbl 9 HRESULT SetSecurityFlags(DWORD Flags)
FlagsDWORDinHTTPS証明書検証やリダイレクト動作を制御するセキュリティフラグ。
vtbl 10 HRESULT GetSecurityFlags(DWORD* pFlags)
pFlagsDWORD*out現在のセキュリティフラグを受け取る出力ポインタ。

HSP用 COM定義

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

出力引数: 
#define global IID_IBackgroundCopyJobHttpOptions "{F1BD1079-9F01-4BDC-8036-F09B70095066}"
#usecom global IBackgroundCopyJobHttpOptions IID_IBackgroundCopyJobHttpOptions "{}"
#comfunc global IBackgroundCopyJobHttpOptions_SetClientCertificateByID    3 int,wstr,var
#comfunc global IBackgroundCopyJobHttpOptions_SetClientCertificateByName  4 int,wstr,wstr
#comfunc global IBackgroundCopyJobHttpOptions_RemoveClientCertificate     5
#comfunc global IBackgroundCopyJobHttpOptions_GetClientCertificate        6 var,var,var,var
#comfunc global IBackgroundCopyJobHttpOptions_SetCustomHeaders            7 wstr
#comfunc global IBackgroundCopyJobHttpOptions_GetCustomHeaders            8 var
#comfunc global IBackgroundCopyJobHttpOptions_SetSecurityFlags            9 int
#comfunc global IBackgroundCopyJobHttpOptions_GetSecurityFlags            10 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。