共用方式為

PeerDistClientAddContentInformation 函式 (peerdist.h)

  • 發行項

PeerDistClientAddContentInformation 函式會新增與 PeerDistClientOpenContent 所開啟之內容句柄相關聯的內容資訊。

語法

DWORD PeerDistClientAddContentInformation(
  [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

pBuffer 陣列中的位元組數目。

[in] pBuffer

包含內容信息的緩衝區指標。 此緩衝區在加入作業期間必須維持有效狀態。 呼叫端在新增作業完成之前，不得使用此緩衝區。

[in] lpOverlapped

重疊結構的指標。 重疊結構的內部成員包含異步操作的完成狀態。 Offset 和 OffsetHigh 是保留的，而且必須是 0。

傳回值

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

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

備註

若要從對等發佈服務擷取內容數據，客戶端必須藉由呼叫 PeerDistClientAddContentInformation 函式，新增它從內容伺服器接收的內容資訊。 新增所有內容信息數據后，必須呼叫 PeerDistClientCompleteContentInformation 函式。 一旦 PeerDistClientCompleteContentInformation 完成，用戶端就可以呼叫 PeerDistClientStreamRead 或 PeerDistClientBlockRead，從對等散發系統擷取數據。

在單一內容句柄上多次呼叫此函式時，呼叫端必須等候每個作業完成，才能進行下一次呼叫。

應用程式不限於使用單一 PeerDistClientAddContentInformation API 呼叫來新增內容資訊，因為可以新增該內容資訊的一部分。 當有更多內容資訊可用時，應用程式可以再次呼叫 PeerDistClientAddContentInformation。 當應用程式完成新增整個內容資訊時，它必須接著呼叫 PeerDistClientCompleteContentInformation。

規格需求

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

另請參閱

PeerDistClientCompleteContentInformation

PeerDistClientOpenContent

PeerDistStartup