Share via

IProgressDialog::SetCancelMsg-Methode (shlobj_core.h)

  • Artikel

Legt eine Meldung fest, die angezeigt wird, wenn der Benutzer den Vorgang abbricht.

Syntax

HRESULT SetCancelMsg(
  [in] PCWSTR  pwzCancelMsg,
       LPCVOID pvResevered
);

Parameter

[in] pwzCancelMsg

Typ: PCWSTR

Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die die anzuzeigende Nachricht enthält.

pvResevered

Typ: LPCVOID

Reserviert. Auf NULL festgelegt.

Rückgabewert

Typ: HRESULT

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

Hinweise

Obwohl der Benutzer auf Abbrechen klickt, kann die Anwendung IProgressDialog::StopProgressDialog nicht sofort aufrufen, um das Dialogfeld zu schließen. Die Anwendung muss warten, bis sie das nächste Mal IProgressDialog::HasUserCancelled aufruft , um festzustellen, dass der Benutzer den Vorgang abgebrochen hat. Da diese Verzögerung erheblich sein kann, gibt das Dialogfeld "Fortschritt" dem Benutzer sofortiges Feedback, indem die Textzeilen 1 und 2 gelöscht und die Meldung "Abbrechen" in Zeile 3 angezeigt wird. Die Meldung soll den Benutzer darüber informieren, dass die Verzögerung normal ist und dass das Statusdialogfeld in Kürze geschlossen wird. Es ist in der Regel auf etwa "Bitte warten, während ..." festgelegt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlobj_core.h
DLL Shell32.dll (Version 5.0 oder höher)

Weitere Informationen

IProgressDialog