共用方式為

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 結構的 Offset 和 OffsetHigh 成員，即可指定從內容開頭新增此數據的位元移。 OffsetHigh 成員必須設定為位元移較高的32位，而 Offset 成員必須設定為位元移的較低32位。

傳回值

如果函式成功，傳回值 會ERROR_IO_PENDING。 否則，此函式可能會傳回下列其中一個值：

傳回碼 Description
ERROR_INVALID_PARAMETER
 一或多個參數無效。
ERROR_INVALID_HANDLE
 hPeerDist 或 hContent 句柄無效。
ERROR_ACCESS_DISABLED_BY_POLICY
 群組原則 會停用此功能。
PEERDIST_ERROR_SERVICE_UNAVAILABLE
 服務無法使用。

備註

已使用此函式新增且通過驗證的數據可供其他對等或託管快取下載。 對等散發服務會將此數據儲存在其本機快取中。

如果 API 完成 PEERDIST_ERROR_OUT_OF_BOUNDS，這表示重疊結構中指定的位移超出內容結尾。

規格需求

需求 值
最低支援的用戶端 Windows 7 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 peerdist.h
程式庫 PeerDist.lib
Dll PeerDist.dll

另請參閱

PeerDistClientBlockRead

PeerDistClientStreamRead

PeerDistStartup