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 |
---|---|
|
一或多個參數無效。 |
|
hPeerDist 句柄無效。 |
|
群組原則 會停用此功能。 |
|
服務無法使用。 |
備註
若要從對等發佈服務擷取內容數據,客戶端必須藉由呼叫 PeerDistClientAddContentInformation 函式,新增它從內容伺服器接收的內容資訊。 新增所有內容信息數據后,必須呼叫 PeerDistClientCompleteContentInformation 函式。 一旦 PeerDistClientCompleteContentInformation 完成,用戶端就可以呼叫 PeerDistClientStreamRead 或 PeerDistClientBlockRead,從對等散發系統擷取數據。
在單一內容句柄上多次呼叫此函式時,呼叫端必須等候每個作業完成,才能進行下一次呼叫。
應用程式不限於使用單一 PeerDistClientAddContentInformation API 呼叫來新增內容資訊,因為可以新增該內容資訊的一部分。 當有更多內容資訊可用時,應用程式可以再次呼叫 PeerDistClientAddContentInformation。 當應用程式完成新增整個內容資訊時,它必須接著呼叫 PeerDistClientCompleteContentInformation。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 7 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 R2 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | peerdist.h |
程式庫 | PeerDist.lib |
Dll | PeerDist.dll |