PeerDistClientCancelAsyncOperation-Funktion (peerdist.h)

Die Funktion PeerDistClientCancelAsyncOperation bricht den asynchronen Vorgang ab, der einer OVERLAPPED-Struktur und dem von PeerDistClientOpenContent zurückgegebenen Inhaltshandle zugeordnet ist.

Syntax

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

Parameter

[in] hPeerDist

Eine vonPeerDistStartup zurückgegebene PEERDIST_INSTANCE_HANDLE.

[in] hContentHandle

Ein Inhaltshandle, das durch den Aufruf der PeerDistClientOpenContent-Funktion geöffnet wird.

[in, optional] pOverlapped

Zeiger auf eine ÜBERLAPPENDE Struktur, die die daten des abgebrochenen asynchronen Vorgangs enthält. Wenn der Zeiger NULL ist, werden alle asynchronen Vorgänge für das angegebene Inhaltshandle abgebrochen.

Rückgabewert

Die Funktion gibt ERROR_SUCCESS Wert zurück, wenn der der angegebenen OVERLAPPED-Struktur zugeordnete Vorgang erfolgreich abgebrochen wurde. Andernfalls gibt die Funktion möglicherweise einen der folgenden Werte zurück:

Hinweise

Diese Funktion bricht den Vorgang synchron ab, wird aber erst zurückgegeben, wenn das Abbruchergebnis an den Vervollständigungsport gesendet oder das Warteereignis auf den signalierten Zustand festgelegt ist. Alle Threads in Wartevorgängen können den Vervollständigungshinweis für den Vorgang vor oder nach dem Zurückgeben der Funktion PeerDistClientCancelAsyncOperation erhalten.

Diese Funktion garantiert nicht, dass der Vorgang als abgebrochen abgeschlossen wird. Das Abbruchergebnis wird nur veröffentlicht, wenn keine anderen Ergebnisse veröffentlicht wurden.

Um erfolgreich abgebrochene Vorgänge zu bestätigen, sollte getOverlappedResult mit einer erwarteten Rückgabe von FALSE aufgerufen werden.

Darüber hinaus gibt das Aufrufen von GetLastError unmittelbar nach einem erfolgreichen PeerDistClientCancelAsyncOperation den ERROR_OPERATION_ABORTED Fehlercode zurück.

Anforderungen

Weitere Informationen

PeerDistServerCancelAsyncOperation