PeerDistServerCancelAsyncOperation-Funktion (peerdist.h)

  • Artikel

Die Funktion PeerDistServerCancelAsyncOperation bricht den asynchronen Vorgang ab, der dem Inhaltsbezeichner und der OVERLAPPED-Struktur zugeordnet ist.

Syntax

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

Parameter

[in] hPeerDist

Eine vonPeerDistStartup zurückgegebene PEERDIST_INSTANCE_HANDLE.

cbContentIdentifier

Die Länge des Inhaltsbezeichners in Bytes.

[in] pContentIdentifier

Zeiger auf ein Array, das den Inhaltsbezeichner enthält.

[in] pOverlapped

Zeiger auf eine ÜBERLAPPENDE Struktur, die die daten des abgebrochenen asynchronen Vorgangs enthält.

Rückgabewert

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

Rückgabecode Beschreibung
ERROR_INVALID_PARAMETER
 Mindestens ein Parameter ist ungültig.
ERROR_INVALID_HANDLE
 Das hPeerDist-Handle ist ungültig.
PEERDIST_ERROR_OPERATION_NOT_FOUND
 Der Vorgang für die ÜBERLAPPENDE Struktur wurde nicht gefunden.
ERROR_ACCESS_DISABLED_BY_POLICY
 Das Feature wird von Gruppenrichtlinie deaktiviert.
PEERDIST_ERROR_SERVICE_UNAVAILABLE
 Der Dienst ist nicht verfügbar.

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 Status "Signaled" festgelegt ist. Alle Threads in Wartevorgängen können den Vervollständigungshinweis für den Vorgang vor oder nach dem Zurückgeben der Funktion PeerDistServerCancelAsyncOperation 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 PeerDistServerCancelAsyncOperation den ERROR_OPERATION_ABORTED Fehlercode zurück.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile peerdist.h
Bibliothek PeerDist.lib
DLL PeerDist.dll

Weitere Informationen

PeerDistClientCancelAsyncOperation

PeerDistClientOpenContent