ホーム › Networking.BackgroundIntelligentTransferService › IBitsPeer
IBitsPeer
COM公式ドキュメント
IBitsPeer は、ネイバーフッド内のピアに関する情報を取得するために使用します。
メソッド 3
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
ピアを一意に識別するサーバープリンシパル名を取得します。
| pName | LPWSTR* | out | ピアのサーバープリンシパル名を含む、null で終わる文字列です。プリンシパル名は server$.domain.suffix という形式です。使用後は CoTaskMemFree 関数を呼び出して pName を解放してください。 |
戻り値
このメソッドは次の戻り値を返します。
| 戻り値 | 説明 |
|---|---|
| 成功 |
解説(Remarks)
プリンシパル名はピアコンピューターの一意な識別情報を保証するものであり、Kerberos が認証する対象のエンティティです。
ピアが認証済みかどうかを判定します。
| pAuth | BOOL* | out | ピアが認証済みの場合は TRUE、それ以外の場合は FALSE です。 |
戻り値
このメソッドは次の戻り値を返します。
| 戻り値 | 説明 |
|---|---|
| 成功 |
解説(Remarks)
BITS は認証されていないピアからコンテンツをダウンロードできません。ピアが検出された時点では、まだ認証されていない状態です。BITS は、ピアキャッシュが有効なジョブをダウンロードする際にピアへ接続し、そのピアに初めて接続したときに認証を行います。
ピアがコンテンツを提供できる状態(オンライン)かどうかを判定します。
| pOnline | BOOL* | out | ピアがコンテンツを提供できる場合は TRUE、それ以外の場合は FALSE です。 |
戻り値
このメソッドは次の戻り値を返します。
| 戻り値 | 説明 |
|---|---|
| 成功 |
解説(Remarks)
BITS がこのピアからコンテンツをダウンロードしている最中にピアがオフラインになった場合、BITS は直ちにオリジンサーバーからのダウンロードを開始します。
ピアが長時間オフラインのままである場合、BITS はそのピアをネイバーフッドから削除します。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
出力引数:
#define global IID_IBitsPeer "{659CDEA2-489E-11D9-A9CD-000D56965251}" #usecom global IBitsPeer IID_IBitsPeer "{}" #comfunc global IBitsPeer_GetPeerName 3 var #comfunc global IBitsPeer_IsAuthenticated 4 var #comfunc global IBitsPeer_IsAvailable 5 var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IBitsPeer "{659CDEA2-489E-11D9-A9CD-000D56965251}" #usecom global IBitsPeer IID_IBitsPeer "{}" #comfunc global IBitsPeer_GetPeerName 3 sptr #comfunc global IBitsPeer_IsAuthenticated 4 sptr #comfunc global IBitsPeer_IsAvailable 5 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。