LPFNPSPCALLBACKW-Rückruffunktion (prsht.h)

Artikel
11/20/2024

Gibt eine anwendungsdefinierte Rückruffunktion an, die von einem Eigenschaftenblatt aufgerufen wird, wenn eine Seite erstellt wird und wann sie zerstört werden soll. Eine Anwendung kann diese Funktion verwenden, um Initialisierungs- und Bereinigungsvorgänge für die Seite auszuführen.

Syntax

LPFNPSPCALLBACKW Lpfnpspcallbackw;

UINT Lpfnpspcallbackw(
            HWND hwnd,
  [in]      UINT uMsg,
  [in, out] _PROPSHEETPAGEW *ppsp
)
{...}

Parameter

hwnd

Typ: HWND-

Reserviert; muss NULL-sein.

[in] uMsg

Typ: UINT-

Aktionsflagge. Dieser Parameter kann einer der folgenden Werte sein:

Wert	Bedeutung
PSPCB_ADDREF	Version 5.80 oder höher. Es wird eine Seite erstellt. Der Rückgabewert wird nicht verwendet.
PSPCB_CREATE	Es wird ein Dialogfeld für eine Seite erstellt. Geben Sie "nonzero" zurück, damit sie erstellt werden kann, oder null, um dies zu verhindern.
PSPCB_RELEASE	Eine Seite wird zerstört. Der Rückgabewert wird ignoriert.

[in, out] ppsp

Typ: LPPROPSHEETPAGE-

Zeiger auf eine PROPSHEETPAGE- Struktur, die die zu erstellende oder zerstörte Seite definiert. Weitere Erläuterungen finden Sie im Abschnitt "Anmerkungen".

Rückgabewert

Typ: UINT-

Der Rückgabewert hängt vom Wert des uMsg--Parameters ab.

Bemerkungen

Eine Anwendung muss die Adresse dieser Rückruffunktion im pfnCallback- Mitglied einer PROPSHEETPAGE- Struktur angeben, bevor die Struktur an die CreatePropertySheetPage--Funktion übergeben wird.

Hinweis Das Eigenschaftenblatt befindet sich im Prozess der Bearbeitung der Seitenliste, wenn diese Funktion aufgerufen wird. Versuchen Sie beim Behandeln dieser Benachrichtigung nicht, Seiten hinzuzufügen, zu entfernen oder einzufügen. Dies führt zu unvorhersehbaren Ergebnissen.

Mit Ausnahme des lParam Mitglieds sollte Ihre Anwendung die PROPSHEETPAGE- Struktur nicht ändern. Dies führt zu unvorhersehbaren Ergebnissen. Das lParam Member enthält anwendungsdefinierte Daten und kann nach Bedarf geändert werden.

Anmerkung

Der prsht.h-Header definiert LPFNPSPCALLBACK als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	prsht.h

Freigeben über