IIOCancelInformation::SetCancelInformation-Methode (shobjidl_core.h)

Legt Informationen fest, die bereitgestellt werden, wenn ein Benutzer auf der Fortschritts-Benutzeroberfläche Abbrechen auswählt. Ermöglicht dem Standard-Objekt, den Statusdialogthread über den Prozessthread zu informieren, damit das Statusdialogfeld dem Prozessthread die Meldungs-ID senden kann, wenn der Benutzer auf Abbrechen klickt.

Syntax

HRESULT SetCancelInformation(
  [in] DWORD dwThreadID,
  [in] UINT  uMsgCancel
);

Parameter

[in] dwThreadID

Art: DWORD

Die ID des abzubrechenden Prozessthreads.

[in] uMsgCancel

Typ: UINT

Die Abbruchnachricht, die an den Thread gesendet werden soll.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn der Benutzer auf der Statusbenutzeroberfläche Abbrechen auswählt, bricht die dwThreadID alle ausstehenden oder zukünftigen Eingabe-/Ausgabeanforderungen (E/A) ab. Außerdem wird die vom Statusdialogfeld empfangene uMsgCancel-Nachricht an den Thread gesendet, um ihn anzuweisen, einen Wartezustand zu beenden, wenn asynchrone E/A ausstehend ist.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)
DLL	Shell32.dll