对等分发 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	用于向本地缓存提供内容。 通常，当无法在本地网络上找到数据时，可以使用 ERROR_TIMEOUT 或 PEERDIST_ERROR_MISSING_DATA 完成 PeerDistClientBlockRead 或 PeerDistClientStreamRead 时完成此操作。
PeerDistClientBlockRead	提供对内容流的随机访问。
PeerDistClientStreamRead	提供对内容流的顺序访问。
PeerDistClientFlushContent	删除以前添加到本地对等分发系统的内容。
PeerDistClientCancelAsyncOperation	取消与 OVERLAPPED 结构和 PeerDistClientOpenContent 返回的内容句柄关联的异步操作。

 

以下函数仅在“服务器”方案中受支持。

服务器函数	说明
PeerDistServerPublishStream	创建 PEERDIST_STREAM_HANDLE 可与 PeerDistServerPublishAddToStream 一起使用，以便为内容流创建内容信息。
PeerDistServerPublishAddToStream	将数据添加到 PeerDist 流句柄引用的流。
PeerDistServerPublishCompleteStream	调用 以指示所有数据都已添加到流中。
PeerDistServerCloseStreamHandle	关闭流句柄。
PeerDistServerUnpublish	取消发布以前在对等分发服务中发布的内容。
PeerDistServerOpenContentInformation	打开已发布内容的 PEERDIST_CONTENTINFO_HANDLE 。
PeerDistServerOpenContentInformationEx	打开已发布内容的 PEERDIST_CONTENTINFO_HANDLE 。
PeerDistServerRetrieveContentInformation	检索与已发布内容关联的内容信息。
PeerDistServerCloseContentInformation	PEERDIST_CONTENTINFO_HANDLE 由 PeerDistServerOpenContentInformation 打开。
PeerDistServerCancelAsyncOperation	取消与内容标识符和 OVERLAPPED 结构关联的异步操作。