Share via


對等散發 API 函式

Microsoft 對等散發服務支援消費者角色和發行者角色案例的功能。

下列函式在「用戶端」和「伺服器」案例中都是常見的。

一般函數 描述
PeerDistStartup 建立新的 PEERDIST_INSTANCE_HANDLE 實例,該實例必須傳遞至所有其他對等散發 API。
PeerDistShutdown 釋放呼叫 PeerDistStartup所配置的資源。
PeerDistGetStatus 傳回對等散發服務的目前狀態。
PeerDistGetStatusEx 傳回對等散發服務的目前狀態和功能。
PeerDistGetOverlappedResult 擷取非同步作業的結果。
PeerDistRegisterForStatusChangeNotification 要求對等散發服務在發生狀態變更時通知呼叫端。
PeerDistRegisterForStatusChangeNotificationEx 要求對等散發服務在發生狀態變更時通知呼叫端。
PeerDistUnregisterForStatusChangeNotification 取消註冊與所提供控制碼相關聯之會話的狀態變更通知。

 

只有在「用戶端」案例中才支援下列函式。

用戶端函數 描述
PeerDistClientOpenContent 開啟並傳回參考該內容的 PEERDIST_CONTENT_HANDLE
PeerDistClientCloseContent 關閉 PEERDIST_CONTENT_HANDLE
PeerDistClientGetInformationByHandle 從對等散發服務擷取特定內容控制碼的其他資訊。
PeerDistClientAddContentInformation 新增與 PEERDIST_CONTENT_HANDLE相關聯的內容資訊。 PEERDIST_CONTENT_HANDLE可以與任何內容資訊相關聯。
PeerDistClientCompleteContentInformation 表示內容資訊的結尾。
PeerDistClientAddData 用來將內容提供給本機快取。 這通常是在區域網路上找不到資料時完成,如 PeerDistClientBlockReadPeerDistClientStreamRead 完成 時ERROR_TIMEOUTPEERDIST_ERROR_MISSING_DATA
PeerDistClientBlockRead 提供內容資料流程的隨機存取。
PeerDistClientStreamRead 提供內容資料流程的循序存取。
PeerDistClientFlushContent 移除先前新增至本機對等散發系統的內容。
PeerDistClientCancelAsyncOperation 取消與 OVERLAPPED 結構相關聯的非同步作業,以及 PeerDistClientOpenContent所傳回的內容控制碼。

 

只有在「伺服器」案例中才支援下列函式。

伺服器函式 描述
PeerDistServerPublishStream 建立可與PeerDistServerPublishAddToStream搭配使用的PEERDIST_STREAM_HANDLE,以建立內容資料流程的內容資訊。
PeerDistServerPublishAddToStream 將資料加入 PeerDist 資料流程控制碼所參考的資料流程。
PeerDistServerPublishCompleteStream 呼叫 以指出所有資料都已新增至資料流程。
PeerDistServerCloseStreamHandle 關閉資料流程控制碼。
PeerDistServerUnpublish 解除發佈先前在對等發佈服務中發佈的內容。
PeerDistServerOpenContentInformation 開啟 已發佈內容的PEERDIST_CONTENTINFO_HANDLE
PeerDistServerOpenContentInformationEx 開啟 已發佈內容的PEERDIST_CONTENTINFO_HANDLE
PeerDistServerRetrieveContentInformation 擷取與已發佈內容相關聯的內容資訊。
PeerDistServerCloseContentInformation PEERDIST_CONTENTINFO_HANDLE由 PeerDistServerOpenContentInformation開啟。
PeerDistServerCancelAsyncOperation 取消與內容識別碼和 OVERLAPPED 結構相關聯的非同步作業。