共用方式為

PeerDistClientCancelAsyncOperation 函式 (peerdist.h)

  • 發行項

PeerDistClientCancelAsyncOperation 函式會取消與 OVERLAPPED 結構相關聯的異步操作，以及 PeerDistClientOpenContent 所傳回的內容句柄。

語法

DWORD PeerDistClientCancelAsyncOperation(
  [in]           PEERDIST_INSTANCE_HANDLE hPeerDist,
  [in]           PEERDIST_CONTENT_HANDLE  hContentHandle,
  [in, optional] LPOVERLAPPED             pOverlapped
);

參數

[in] hPeerDist

PeerDistStartup 傳回的PEERDIST_INSTANCE_HANDLE。

[in] hContentHandle

PeerDistClientOpenContent 函式呼叫所開啟的內容句柄。

[in, optional] pOverlapped

包含取消異步操作數據的 重疊 結構指標。 如果指標為 NULL ，則會取消指定內容句柄的所有異步操作。

傳回值

如果成功取消與指定之 OVERLAPPED 結構相關聯的作業，函式會傳回ERROR_SUCCESS值。 否則，此函式可能會傳回下列其中一個值：

傳回碼 Description
ERROR_INVALID_PARAMETER
 一或多個參數無效。
ERROR_INVALID_HANDLE
 hPeerDist 句柄無效。
PEERDIST_ERROR_OPERATION_NOT_FOUND
 找不到與指定 之 OVERLAPPED 結構相關聯的作業。
ERROR_ACCESS_DISABLED_BY_POLICY
 群組原則 會停用此功能。
PEERDIST_ERROR_SERVICE_UNAVAILABLE
 服務無法使用。

備註

此函式會同步取消作業，但在取消結果張貼到完成埠或等候事件設定為訊號狀態之前，才會傳回。 等候中的任何線程都可以在 PeerDistClientCancelAsyncOperation 函式傳回之前或之後收到作業的完成通知。

此函式不保證作業會如已取消般完成。 只有在未張貼其他結果時，才會張貼取消結果。

若要確認已成功取消的作業，應該呼叫 GetOverlappedResult 並預期傳回 FALSE。

此外，在成功的PeerDistClientCancelAsyncOperation 之後立即呼叫 GetLastError 會傳回ERROR_OPERATION_ABORTED錯誤碼。

規格需求

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

另請參閱

PeerDistServerCancelAsyncOperation