PeerDistClientAddData 関数 (peerdist.h)
PeerDistClientAddData 関数は、ローカル キャッシュにコンテンツを提供するために使用されます。 通常、これは、 PeerDistClientBlockRead または PeerDistClientStreamRead が ERROR_TIMEOUT または PEERDIST_ERROR_MISSING_DATA で完了したときに示されているように、ローカル ネットワーク上でデータが見つからなかった場合に行われます。
構文
DWORD PeerDistClientAddData(
[in] PEERDIST_INSTANCE_HANDLE hPeerDist,
[in] PEERDIST_CONTENT_HANDLE hContentHandle,
DWORD cbNumberOfBytes,
[in] PBYTE pBuffer,
[in] LPOVERLAPPED lpOverlapped
);
パラメーター
[in] hPeerDist
PeerDistStartup によって返されるPEERDIST_INSTANCE_HANDLE。
[in] hContentHandle
PeerDistClientOpenContent によって返されるPEERDIST_CONTENT_HANDLE。
cbNumberOfBytes
ローカル キャッシュに追加するバイト数。
[in] pBuffer
ローカル キャッシュに追加するデータを含むバッファーへのポインター。 このバッファーは、追加操作の間有効なままである必要があります。 呼び出し元は、追加操作が完了するまで、このバッファーを使用しないでください。
[in] lpOverlapped
OVERLAPPED 構造体へのポインター。 このデータが追加されるコンテンツの先頭からのバイト オフセットは、OVERLAPPED 構造体の Offset メンバーと OffsetHigh メンバーを設定することによって指定されます。 OffsetHigh メンバーはバイト オフセットの上位 32 ビットに設定する必要があり、Offset メンバーはバイト オフセットの下位 32 ビットに設定する必要があります。
戻り値
関数が成功した場合、戻り値は ERROR_IO_PENDING。 それ以外の場合は、関数から次の値のいずれかが返されます。
リターン コード | 説明 |
---|---|
|
1 つ以上のパラメーターが無効です。 |
|
hPeerDist または hContent ハンドルが無効です。 |
|
この機能は、グループ ポリシーによって無効になっています。 |
|
サービスを利用できません。 |
注釈
この関数で追加され、検証に合格したデータは、他のピアまたはホスト型キャッシュからダウンロードできます。 ピア配布サービスは、このデータをローカル キャッシュに格納します。
API が PEERDIST_ERROR_OUT_OF_BOUNDS で完了した場合、これは、重複する構造体で指定されたオフセットがコンテンツの末尾を超えていることを示します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 7 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | peerdist.h |
Library | PeerDist.lib |
[DLL] | PeerDist.dll |