SoftwareUpdateMessageBox-Funktion (shlobj.h)

Artikel
03/04/2024

Zeigt ein Standardmeldungsfeld an, das verwendet werden kann, um einen Benutzer darüber zu informieren, dass eine Anwendung aktualisiert wurde.

Syntax

DWORD SoftwareUpdateMessageBox(
  [in, optional]  HWND           hWnd,
  [in]            PCWSTR         pszDistUnit,
                  DWORD          dwFlags,
  [out, optional] LPSOFTDISTINFO psdi
);

Parameter

[in, optional] hWnd

Typ: HWND

Ein Handle für das übergeordnete Fenster.

[in] pszDistUnit

Typ: PCWSTR

Der Zeichenfolgenwert, der den Bezeichner für die Codeverteilungseinheit enthält. Bei ActiveX-Steuerelementen ist pszDistUnit in der Regel eine GUID.

dwFlags

Art: DWORD

Reserviert. Muss auf 0 festgelegt werden.

[out, optional] psdi

Typ: LPSOFTDISTINFO

Ein Zeiger auf eine SOFTDISTINFO-Struktur , die bei erfolgreicher Rückgabe dieser Methode die Updateinformationen empfängt. Das cbSize-Element muss mit sizeof(SOFTDISTINFO)initialisiert werden.

Rückgabewert

Art: DWORD

Gibt einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
IDNO	Der Benutzer hat im Dialogfeld auf die Schaltfläche Nicht aktualisieren geklickt.
IDYES	Der Benutzer hat auf die Schaltfläche Jetzt aktualisieren oder Info aktualisieren geklickt. Die Anwendung sollte zur HTML-Seite navigieren, auf die das szHREF-Element der Struktur verweist, auf die von psdi verwiesen wird.
IDIGNORE	Es gibt kein ausstehendes Softwareupdate.
IDABORT	Ein Fehler ist aufgetreten.

Hinweise

Die bevorzugte Methode zum Behandeln von Updates besteht darin, ein Kanaldefinitionsformat (Channel Definition Format, CDF) mit einem OSD-Vokabular (Open Software Description) zu erstellen und die Verknüpfung OSD-fähig zu machen. Ausführliche Informationen finden Sie in der Dokumentation zum Kanaldefinitionsformat .

Die SoftwareUpdateMessageBox-Funktion ist für den Fall vorgesehen, in dem Shell-Tastenkombinationshaken nicht funktionieren. Ein Beispiel ist eine Anwendung, die nicht im Startmenü installiert wurde. Wenn diese Anwendung eine eigene Softwareupdateüberprüfung durchführen muss, sollte sie diese Funktion verwenden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlobj.h
DLL	Shdocvw.dll

Freigeben über