共用方式為

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 結構相關聯的作業，函式會傳回ERROR_SUCCESS值。 否則，此函式可能會傳回下列其中一個值：

傳回碼 Description
ERROR_INVALID_PARAMETER
 一或多個參數無效。
ERROR_INVALID_HANDLE
 hPeerDist 句柄無效。
PEERDIST_ERROR_OPERATION_NOT_FOUND
 找不到 重疊 結構的作業。
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
程式庫 PeerDist.lib
Dll PeerDist.dll

另請參閱

PeerDistClientCancelAsyncOperation

PeerDistClientOpenContent