通过

PeerDistServerCancelAsyncOperation 函数 (peerdist.h)

  • 项目

PeerDistServerCancelAsyncOperation 函数取消与内容标识符和 OVERLAPPED 结构关联的异步操作。

语法

DWORD PeerDistServerCancelAsyncOperation(
  [in] PEERDIST_INSTANCE_HANDLE hPeerDist,
       DWORD                    cbContentIdentifier,
  [in] PBYTE                    pContentIdentifier,
  [in] LPOVERLAPPED             pOverlapped
);

参数

[in] hPeerDist

PeerDistStartup 返回的PEERDIST_INSTANCE_HANDLE。

cbContentIdentifier

内容标识符的长度（以字节为单位）。

[in] pContentIdentifier

指向包含内容标识符的数组的指针。

[in] pOverlapped

指向包含取消异步操作数据的 OVERLAPPED 结构的指针。

返回值

如果成功取消与 OVERLAPPED 结构关联的操作，函数将返回ERROR_SUCCESS值。 否则，该函数返回以下值之一：

返回代码 说明
ERROR_INVALID_PARAMETER
 一个或多个参数无效。
ERROR_INVALID_HANDLE
 hPeerDist 句柄无效。
PEERDIST_ERROR_OPERATION_NOT_FOUND
 找不到 OVERLAPPED 结构的操作。
ERROR_ACCESS_DISABLED_BY_POLICY
 组策略禁用该功能。
PEERDIST_ERROR_SERVICE_UNAVAILABLE
 服务不可用。

注解

此函数将同步取消操作，但在取消结果发布到完成端口或等待事件设置为“已发出信号”状态之前不会返回。 等待中的任何线程都可以在 PeerDistServerCancelAsyncOperation 函数返回之前或之后收到操作的完成通知。

此函数不保证操作将作为已取消完成。 仅当未发布其他结果时，才会发布取消结果。

若要确认已成功取消操作，应调用 GetOverlappedResult 并预期返回 FALSE。

此外，在 PeerDistServerCancelAsyncOperation 成功后立即调用 GetLastError 将返回ERROR_OPERATION_ABORTED错误代码。

要求

要求 值
最低受支持的客户端 Windows 7 专业版 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 peerdist.h
Library PeerDist.lib
DLL PeerDist.dll

另请参阅

PeerDistClientCancelAsyncOperation

PeerDistClientOpenContent