LPFNPSPCALLBACKA-Rückruffunktion (prsht.h)

  • Artikel

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

LPFNPSPCALLBACKA Lpfnpspcallbacka;

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

Parameter

hwnd

Typ: HWND

Reserviert; muss NULL sein.

[in] uMsg

Typ: UINT

Aktionsflag. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert Bedeutung
PSPCB_ADDREF

Version 5.80 oder höher. Eine Seite wird erstellt. Der Rückgabewert wird nicht verwendet.
PSPCB_CREATE
 Ein Dialogfeld für eine Seite wird erstellt. Geben Sie ungleich null zurück, um die Erstellung zu ermöglichen, 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 Seite definiert, die erstellt oder zerstört wird. Weitere Informationen finden Sie im Abschnitt "Hinweise".

Rückgabewert

Typ: UINT

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

Hinweise

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

Hinweis Das Eigenschaftenblatt bearbeitet gerade die Liste der Seiten, wenn diese Funktion aufgerufen wird. Versuchen Sie nicht, Seiten hinzuzufügen, zu entfernen oder einzufügen, während Sie diese Benachrichtigung behandeln. Dies führt zu unvorhersehbaren Ergebnissen.
 
Mit Ausnahme des lParam-Elements sollte Ihre Anwendung die PROPSHEETPAGE-Struktur nicht ändern. Dies führt zu unvorhersehbaren Ergebnissen. Das lParam-Element enthält anwendungsdefinierte Daten und kann bei Bedarf geändert werden.

Hinweis

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
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile prsht.h